Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Herstellen einer Verbindung mit Jira Cloud
Jira Cloud ist eine von Atlassian entwickelte Plattform. Die Plattform umfasst Produkte zur Problemverfolgung, mit denen Teams ihre Agile-Projekte planen und verfolgen können. Als Jira-Cloud-Benutzer enthält Ihr Konto Daten zu Ihren Projekten, wie z. B. Probleme, Workflows und Ereignisse. Sie können AWS Glue es verwenden, um Ihre Jira Cloud-Daten an bestimmte AWS Dienste oder andere unterstützte Anwendungen zu übertragen.
**Topics**
+ [AWS Glue Unterstützung für Jira Cloud](jira-cloud-support.md)
+ [Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten](jira-cloud-configuring-iam-permissions.md)
+ [Konfigurieren von Jira Cloud](jira-cloud-configuring.md)
+ [Konfigurieren von Jira-Cloud-Verbindungen](jira-cloud-configuring-connections.md)
+ [Lesen aus Jira-Cloud-Entitäten](jira-cloud-reading-from-entities.md)
+ [Verbindungsoptionen für Jira Cloud](jira-cloud-connection-options.md)
+ [Einschränkungen und Hinweise für den Jira-Cloud-Connector](jira-cloud-connector-limitations.md)
# AWS Glue Unterstützung für Jira Cloud
AWS Glue unterstützt Jira Cloud wie folgt:
**Als Quelle unterstützt?**
Ja. Sie können AWS Glue ETL-Jobs verwenden, um Daten aus Jira Cloud abzufragen.
**Als Ziel unterstützt?**
Nein.
**Unterstützte Versionen der Jira-Cloud-API**
Die folgenden Versionen der Jira-Cloud-API werden unterstützt:
+ v3
Informationen zur versionsspezifischen Unterstützung von Entitäten finden Sie unter [Lesen aus Jira-Cloud-Entitäten](jira-cloud-reading-from-entities.md).
# Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten
Die folgende Beispielrichtlinie beschreibt die erforderlichen AWS IAM-Berechtigungen für das Erstellen und Verwenden von Verbindungen. Wenn Sie eine neue Rolle erstellen, erstellen Sie eine Richtlinie, die Folgendes enthält:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Wenn Sie die oben genannte Methode nicht verwenden möchten, verwenden Sie alternativ die folgenden verwalteten IAM-Richtlinien:
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Gewährt Zugriff auf Ressourcen, die verschiedene AWS Glue Prozesse benötigen, um in Ihrem Namen ausgeführt zu werden. Zu diesen Ressourcen gehören AWS Glue Amazon S3, IAM, CloudWatch Logs und Amazon EC2. Wenn Sie die in dieser Richtlinie angegebene Benennungskonvention für Ressourcen einhalten, verfügen AWS Glue Prozesse über die erforderlichen Berechtigungen. Diese Richtlinie wird typischerweise mit Rollen verknüpft, die bei der Definition von Crawlern, Aufträgen und Entwicklungsendpunkten angegeben werden.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Gewährt vollen Zugriff auf AWS Glue Ressourcen, wenn eine Identität, der die Richtlinie zugeordnet ist, die AWS Managementkonsole verwendet. Wenn Sie die Namenskonvention für Ressourcen befolgen, die in dieser Richtlinie angegeben sind, haben Benutzer alle Konsolenfunktionalitäten. Diese Richtlinie wird normalerweise Benutzern der AWS Glue Konsole zugewiesen.
# Konfigurieren von Jira Cloud
Bevor du Daten von Jira Cloud AWS Glue an unterstützte Ziele übertragen kannst, musst du die folgenden Anforderungen erfüllen:
## Mindestanforderungen
Die folgenden Anforderungen sind Mindestanforderungen:
+ Sie haben ein Atlassian-Konto, mit dem Sie das Jira-Softwareprodukt in Jira Cloud verwenden. Weitere Informationen finden Sie unter [Erstellen eines Jira-Cloud-Kontos](#jira-cloud-configuring-creating-jira-cloud-account).
+ Sie müssen ein AWS Konto mit dem Servicezugriff auf AWS Glue erstellt haben.
+ Diese App stellt die Kundenanmeldedaten bereit, die für den sicheren Zugriff auf Ihre Daten AWS Glue verwendet werden, wenn authentifizierte Anrufe an Ihr Konto getätigt werden. Weitere Informationen findest du unter [Enabling OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#enabling-oauth-2-0--3lo-) in der Atlassian Developer-Dokumentation.
Wenn du diese Anforderungen erfüllst, bist du bereit, dich mit deinem Jira AWS Glue Cloud-Konto zu verbinden.
## Erstellen eines Jira-Cloud-Kontos
So erstellen Sie ein Jira-Cloud-Konto:
1. Rufen Sie die [Registrierungsseite von Atlassian](https://id.atlassian.com/signup) auf.
1. Geben Sie Ihre geschäftliche E-Mail-Adresse und Ihren Namen ein und wählen Sie **Zustimmen** aus. Sie erhalten eine Bestätigungs-E-Mail.
1. Nachdem Sie Ihre E-Mail-Adresse bestätigt haben, können Sie ein Passwort erstellen und sich **registrieren**.
1. Geben Sie Ihren Namen und Ihr Passwort ein und wählen Sie **Registrieren**.
1. Sie werden auf eine Seite umgeleitet, auf der Sie Ihre Site eingeben müssen. Geben Sie einen Site-Namen ein und wählen Sie **Zustimmen**.
Sobald Ihre Atlassian-Cloud-Site gestartet ist, können Sie Jira einrichten, indem Sie einige Fragen zu Ihren Projektpräferenzen beantworten.
Anmelden bei einem bestehenden Konto:
1. Rufen Sie die [Anmeldeseite von Atlassian](https://id.atlassian.com/login) auf und geben Sie Ihre Anmeldeinformationen ein.
1. Geben Sie E-Mail-Adresse und Passwort ein und klicken Sie auf **Anmelden**. Sie werden zum Jira-Dashboard umgeleitet.
## Erstellen einer App in Ihrer Jira Cloud
So erstellen Sie eine App in Jira Cloud und erhalten die Client-ID und den geheimen Client-Schlüssel aus der verwalteten Client-App:
1. Rufen Sie [Jira Cloud](https://id.atlassian.com/login) auf und geben Sie Ihre Anmeldeinformationen ein.
1. Wählen Sie **Erstellen** und wählen Sie die **OAuth 2.0-Integrationsoption**.
1. Geben Sie den Namen der App ein, akzeptieren Sie die **AGB** und wählen Sie **Erstellen**.
1. Navigieren Sie zum Abschnitt **Verteilung** im linken Menü und wählen Sie **Bearbeiten**.
1. Im Abschnitt **Verteilungseinstellungen bearbeiten**:
1. Legen Sie als **VERTEILUNGSSTATUS** die Option **Teilen** aus.
1. Geben Sie den Namen des Anbieters ein.
1. Geben Sie die URL für Ihre **Datenschutzrichtlinie** ein. Zum Beispiel https://docs.aws.amazon.com/glue/ latest/dg/security -iam-awsmanpol.html
1. Geben Sie die URL für Ihre **Nutzungsbedingungen** ein (optional).
1. Geben Sie die URL für Ihren **Kundensupport-Kontakt** ein (optional).
1. Wählen Sie Yes/No aus der **ERKLÄRUNG ZU PERSÖNLICHEN DATEN** aus und wählen Sie **Änderungen speichern**.
1. Navigiere im linken Menü für die jeweilige App zu **Berechtigungen**.
1. Wählen Sie für **Jira API** die Option **Hinzufügen** aus. Wählen Sie nach dem Hinzufügen die Option **Konfiguration**.
1. Wählen Sie im Abschnitt **Klassische Bereiche** > **Jira-Plattform-REST-API** die Option **Bereiche bearbeiten** aus und markieren Sie alle Bereiche. Klicken Sie auf **Speichern**.
1. Wählen Sie unter **Detaillierte Bereiche** die Option **Bereiche bearbeiten** und dann die folgenden Bereiche aus:
1. Scrollen Sie nach unten und suchen Sie nach Bereichen. Es gibt zwei Arten von Bereichen, die Sie unter den Überschriften „CRM“ und „Standard“ auswählen müssen.
1. Fügen Sie die folgenden Bereiche hinzu:
```
read:application-role:jira
read:audit-log:jira
read:avatar:jira
read:field:jira
read:group:jira
read:instance-configuration:jira
read:issue-details:jira
read:issue-event:jira
read:issue-link-type:jira
read:issue-meta:jira
read:issue-security-level:jira
read:issue-security-scheme:jira
read:issue-type-scheme:jira
read:issue-type-screen-scheme:jira
read:issue-type:jira
read:issue.time-tracking:jira
read:label:jira
read:notification-scheme:jira
read:permission:jira
read:priority:jira
read:project:jira
read:project-category:jira
read:project-role:jira
read:project-type:jira
read:project-version:jira
read:project.component:jir
read:project.property:jira
read:resolution:jira
read:screen:jira
read:status:jira
read:user:jira
read:workflow-scheme:jira
read:workflow:jira
read:field-configuration:jira
read:issue-type-hierarchy:jira
read:webhook:jira
```
1. Navigieren Sie im linken Menü zu **Authentifizierung** und wählen Sie **Hinzufügen**.
1. Geben Sie eine **Callback-URL wie https://us-east-1.console.aws.amazon.com/gluestudio/ oauth** ein
1. Navigieren Sie im linken Menü zu **Einstellungen** und scrollen Sie nach unten zu den **Authentifizierungsdetails**. Notieren Sie die Client-ID und den geheimen Schlüssel.
# Konfigurieren von Jira-Cloud-Verbindungen
Jira Cloud unterstützt den Grant-Typ AUTHORIZATION\$1CODE für. OAuth2
+ Dieser Zuschusstyp wird als „dreibeiniges“ angesehen, OAuth da er darauf beruht, dass Benutzer zur Authentifizierung des Benutzers an einen Autorisierungsserver eines Drittanbieters weitergeleitet werden. Er wird verwendet, wenn Verbindungen über die Konsole hergestellt werden. AWS Glue Die AWS Glue Konsole leitet den Benutzer zu Jira Cloud weiter, wo er sich anmelden und die angeforderten Berechtigungen für AWS Glue den Zugriff auf seine Jira Cloud-Instanz gewähren muss.
+ Benutzer können sich weiterhin dafür entscheiden, ihre eigene verbundene App in Jira Cloud zu erstellen und ihre eigene Client-ID und ihr eigenes Client-Geheimnis anzugeben, wenn sie Verbindungen über die Konsole herstellen. AWS Glue In diesem Szenario werden sie weiterhin zu Jira Cloud weitergeleitet, um sich anzumelden und den Zugriff auf ihre Ressourcen AWS Glue zu autorisieren.
+ Dieser Gewährungstyp führt zu einem Aktualisierungstoken und einem Zugriffstoken. Das Zugriffstoken ist kurzlebig und kann mithilfe des Aktualisierungstokens automatisch ohne Benutzerinteraktion aktualisiert werden.
+ Eine öffentliche Jira Cloud-Dokumentation zur Erstellung einer verbundenen App für den Authorization Code OAuth Flow findest du unter [Enabling OAuth 2.0 (](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#enabling-oauth-2-0--3lo-)3LO).
Konfigurieren einer Jira-Cloud-Verbindung:
1. Erstellen Sie in AWS Secrets Manager ein Secret mit den folgenden Details:
1. Für die kundenseitig verwaltete verbundene App muss das Geheimnis das Verbrauchergeheimnis der verbundenen App mit `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` als Schlüssel enthalten.
1. Hinweis: Sie müssen ein Geheimnis für die Verbindung in AWS Glue erstellen.
1. Erstellen Sie in AWS Glue Glue Studio eine Verbindung unter **Datenverbindungen**, indem Sie die folgenden Schritte ausführen:
1. Wählen Sie als **Verbindungstyp** Jira Cloud aus.
1. Stellen Sie die Jira-Cloud-Umgebung bereit.
1. Wählen Sie die AWS IAM-Rolle aus, die die folgenden Aktionen übernehmen AWS Glue kann und über Berechtigungen verfügt:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Wählen Sie `secretName` die aus, in die Sie für diese Verbindung die Token einfügen AWS Glue möchten.
1. Wählen Sie die Netzwerkoptionen aus, wenn Sie Ihr Netzwerk verwenden möchten.
1. Erteilen Sie der mit Ihrem AWS Glue Job verknüpften IAM-Rolle `secretName` Leserechte.
# Lesen aus Jira-Cloud-Entitäten
**Voraussetzung**
Ein Jira-Cloud-Objekt, aus dem gelesen werden soll. Sie benötigen den Objektnamen wie Prüfungsunterlagen oder Problem. Die folgende Tabelle zeigt die unterstützten Entitäten.
**Unterstützte Entitäten für Quelle**:
| Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung |
| --- | --- | --- | --- | --- | --- |
| Prüfungsaufzeichnung | Ja | Ja | Nein | Ja | Ja |
| Problem | Ja | Ja | Nein | Ja | Ja |
| Problem-Feld | Nein | Nein | Nein | Ja | Nein |
| Problem-Feldkonfiguration | Ja | Ja | Nein | Ja | Ja |
| Problem-Linktyp | Nein | Nein | Nein | Ja | Nein |
| Problem-Benachrichtigungsschema | Ja | Ja | Nein | Ja | Ja |
| Problem-Sicherheitsschema | Nein | Nein | Nein | Ja | Nein |
| Problemtyp-Schema | Ja | Ja | Ja | Ja | Ja |
| Problemtyp-Bildschirmschema | Ja | Ja | Ja | Ja | Ja |
| Problemtyp | Nein | Nein | Nein | Ja | Nein |
| Jira-Einstellung | Ja | Nein | Nein | Ja | Nein |
| Jira-Einstellung Erweitert | Nein | Nein | Nein | Ja | Nein |
| Jira-Einstellung Global | Nein | Nein | Nein | Ja | Nein |
| Label (Bezeichnung) | Nein | Nein | Nein | Ja | Ja |
| Ich selbst | Ja | Nein | Nein | Ja | Nein |
| Berechtigung | Nein | Nein | Nein | Ja | Nein. |
| Projekt | Ja | Ja | Ja | Ja | Ja |
| Projektkategorie | Nein | Nein | Nein | Ja | Nein |
| Projekttyp | Nein | Nein | Nein | Ja | Nein |
| Server-Info | Nein | Nein | Nein | Ja | Nein |
| Benutzer | Nein | Nein | Nein. | Ja | Nein |
| Workflow | Ja | Ja | Ja | Ja | Ja |
| Workflow-Schema | Nein | Ja | Nein | Ja | Ja |
| Workflow-Schema Projektzuordnung | Ja | Nein | Nein | Ja | Nein |
| Workflow-Status | Nein | Nein | Nein | Ja | Nein |
| Workflow-Status-Kategorie | Nein | Nein | Nein | Ja | Nein |
**Beispiel:**
```
jiracloud_read = glueContext.create_dynamic_frame.from_options(
connection_type="JiraCloud",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "audit-record",
"API_VERSION": "v3"
}
```
**Jira-Cloud-Entität und Felddetails**:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/jira-cloud-reading-from-entities.html)
## Partitionieren von Abfragen
Sie können die zusätzliche Spark-Option `NUM_PARTITIONS` angeben, wenn Sie Parallelität in Spark nutzen möchten. Mit diesem Parameter würde die ursprüngliche Abfrage in `NUM_PARTITIONS` Unterabfragen aufgeteilt, die von Spark-Aufgaben gleichzeitig ausgeführt werden können.
+ `NUM_PARTITIONS`: Die Anzahl an Partitionen.
Beispiel:
```
jiraCloud_read = glueContext.create_dynamic_frame.from_options(
connection_type="JiraCloud",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "issue",
"API_VERSION": "v3",
"NUM_PARTITIONS": "10"
}
```
# Verbindungsoptionen für Jira Cloud
Im Folgenden sind Verbindungsoptionen für Jira Cloud aufgeführt:
+ `ENTITY_NAME` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Der Name Ihres Objekts in Jira Cloud.
+ `API_VERSION` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Version der REST-API von Jira Cloud, die Sie verwenden möchten. Zum Beispiel: v3.
+ `DOMAIN_URL`(Zeichenfolge) – (Erforderlich) Die Jira-Cloud-ID, die Sie verwenden möchten.
+ `SELECTED_FIELDS` (Liste) – Standard: leer(SELECT \$1). Zum Lesen verwendet. Spalten, die Sie für das Objekt auswählen möchten.
+ `FILTER_PREDICATE`(Zeichenfolge) – Standard: leer. Zum Lesen verwendet. Muss das Spark-SQL-Format aufweisen.
+ `QUERY`(Zeichenfolge) – Standard: leer Zum Lesen verwendet. Vollständige Spark-SQL-Abfrage.
+ `NUM_PARTITIONS`(Ganzzahl) – Standard: 1. Zum Lesen verwendet. Anzahl der zu lesenden Partitionen.
# Einschränkungen und Hinweise für den Jira-Cloud-Connector
Im Folgenden finden Sie Einschränkungen oder Hinweise für den Jira-Cloud-Connector:
+ Der `Contains` Operator funktioniert nicht mit dem `resourceName` Feld, das vom `String` Datentyp ist.
+ Wenn kein expliziter Filter angewendet wird, werden standardmäßig nur Probleme der letzten 30 Tage gecrawlt. Benutzer haben die Möglichkeit, diesen Standardfilter zu überschreiben, indem sie einen benutzerdefinierten Filter angeben.