

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.

# Amazon-Ressourcennamen (ARNs) bei Amazon QuickSight
<a name="qs-arns"></a>

Amazon-Ressourcennamen (ARNs) sind eindeutige Bezeichner für AWS-Ressourcen. Ein ARN identifiziert eine Ressource eindeutig über alleAWS, z. B. in IAMPolicies, Amazon Relational Database Service (Amazon RDS) -Tags und API-Aufrufen. So erhalten Sie den ARN eines Amazon QuickSightRessource, können Sie die`Describe`Operation auf der entsprechenden Ressource. 

In diesem Abschnitt erfahren Sie, wie ARNs funktionieren. Das Material hier enthält Beispiele, die speziell auf Amazon ausgerichtet sind QuickSight.

**Topics**
+ [ARN-Formate](qs-arn-format.md)
+ [Amazon QuickSight -Ressourcen-ARNs](qs-resource-arns.md)

# ARN-Formate
<a name="qs-arn-format"></a>

ARNs sind durch Doppelpunkte begrenzt und bestehen aus*Segmente*. Dies sind die durch Doppelpunkte getrennten Teile (`:`) enthalten. Die spezifischen Komponenten und Werte, die in den Segmenten eines ARN verwendet werden, hängen davon ab,AWSDienst, für den die ARN bestimmt ist Im folgenden Beispiel wird gezeigt, wie ARNs erstellt werden.

```
arn:partition:service:region:account-id:resource-id
arn:partition:service:region:account-id:resource-type/resource-id
arn:partition:service:region:account-id:resource-type:resource-id
```

Diese ARNs enthalten die folgenden Segmente:

***`partition`***— Die Partition, in der sich die Ressource befindet. Für standardAWS-Regionen, die Partition ist*aws*. Wenn Sie Ressourcen in anderen Partitionen haben, lautet die Partition*aws-Partitionsname*. Die Aufteilung der Ressourcen in der Region China (Peking) lautet beispielsweise `aws-cn`. 

***`service`***— Der Service-Namespace, der das identifiziertAWSProduct. Beispiel,`quicksight`identifiziert Amazon QuickSight,`s3`identifiziert Amazon S3,`iam`identifiziert IAM,,,,, 

***`region`***— DieAWS-Regionin der sich die Ressource befindet. Die ARNs für einige Ressourcen erfordern keineAWS-Region, sodass diese Komponente in einigen Fällen weggelassen werden kann, wie im Fall von S3. Amazon QuickSight ARNs benötigen eineAWS-Region. 

***`account-id`***— Die ID derAWS-Kontoder Eigentümer der Ressource ist. Wenn Sie die Kontonummer in einem ARN- oder API-Vorgang verwenden, lassen Sie die Bindestriche weg (z. B. 123456789012). Die ARNs für einige Ressourcen erfordern keine Kontonummer. Diese Komponente könnte daher weggelassen werden. Amazon QuickSight ARNs benötigen eineAWS-KontoNummer. Die Kontonummer und dieAWS-Regionwerden in S3-Bucket-ARNs weggelassen, wie im Folgenden gezeigt.

```
arn:aws:s3:::bucket_name
arn:aws:s3:::bucket_name/key_name
```

***`resource`*oder*`resource-type`***— Der Inhalt dieses Teils der ARN variiert je nach Service. Eine Ressourcen-ID kann der Name oder die ID der Ressource (z.`user/Bob`oder`instance/i-1234567890abcdef0`) oder einen Ressourcenpfad. Beispielsweise enthalten einige Ressourcenkennungen eine übergeordnete Ressource (`sub-resource-type/parent-resource/sub-resource`) oder ein Qualifier wie eine Version (*resource-type*:*Ressourcenname*:*Qualifizierer*) enthalten. 

Einige Ressourcen-ARNs können einen Pfad, eine Variable oder einen Platzhalter enthalten. 

Sie können Platzhalterzeichen (`*`und`?`) in jedem ARN-Segment. Ein Sternchen (`*`) steht für kein Zeichen oder eine beliebige Kombination von mehreren Zeichen und ein Fragezeichen (`?`) entspricht einem beliebigen einzelnen Zeichen. Sie können mehrere \$1 oder ? Zeichen in jedem Segment verwenden, allerdings sind Platzhalter nicht segmentübergreifend. Wenn Sie den ARN für Berechtigungen verwenden, vermeiden Sie`*`Platzhalter wenn möglich, um den Zugriff auf nur die erforderlichen Elemente zu beschränken. Im Folgenden sehen Sie einige -Beispiele zur Verwendung von Pfaden, Platzhaltern und Variablen.

Für das folgende Beispiel verwenden wir einen S3-ARN. Sie können dies verwenden, wenn Sie S3 in einer IAMPolicy Berechtigungen erteilen. Dieser S3-ARN zeigt, dass ein Pfad und eine Datei angegeben sind. 

**Anmerkung**  
Der Begriff*Tastenname*wird verwendet, um zu beschreiben, was wie ein Pfad und eine Datei danach aussieht`bucketname/`. Diese werden als Schlüsselnamen bezeichnet, da ein Bucket eigentlich keine Ordnerstrukturen enthält, wie sie im Dateisystem Ihres Computers verwendet werden. Stattdessen lautet der Schrägstrich (`/`) ist ein Trennzeichen, das dazu beiträgt, die Organisation des Buckets intuitiver zu gestalten. In diesem Fall lautet der Bucket-Name`examplebucket`, ist der Tastenname`developers/design_info.doc`. 

```
arn:aws:s3:::examplebucket/my-data/sales-export-2019-q4.json
```

Wenn Sie alle Objekte im Bucket identifizieren möchten, können Sie mithilfe eines Platzhalters angeben, dass alle Schlüsselnamen (oder Pfade und Dateien) wie folgt im ARN enthalten sind.

```
arn:aws:s3:::examplebucket/*
```

Sie können einen Teil eines Schlüsselnamens und den Platzhalter verwenden, um alle Objekte zu identifizieren, die mit einem bestimmten Muster beginnen. In diesem Fall ähnelt es einem Ordnernamen plus einem Platzhalter, wie im Folgenden gezeigt. Dieser ARN enthält jedoch auch alle „Unterordner“ innerhalb von`my-data`.

```
arn:aws:s3:::examplebucket/my-data/*
```

Sie können einen partiellen Namen angeben, indem Sie einen Platzhalter hinzufügen. Dieser identifiziert alle Objekte, die mit beginnen`my-data/sales-export*`. 

```
arn:aws:s3:::examplebucket/my-data/sales-export*
```

In diesem Fall schließt die Angabe mit diesem Platzhalter die Objekte mit Namen wie den folgenden ein:
+ `my-data/sales-export-1.xlsx`
+ `my-data/sales-export-new.txt`
+ `my-data/sales-export-2019/file1.txt`

Sie können Platzhalter beider Typen (Sternchen und Fragezeichen) in Kombination oder getrennt verwenden, wie im Folgenden gezeigt.

```
arn:aws:s3:::examplebucket/my-data/sales-export-2019-q?.*

arn:aws:s3:::examplebucket/my-data/sales-export-20??-q?.*
```

Oder, wenn Sie den ARN zukunftssicher machen möchten, können Sie das gesamte Jahr durch einen Platzhalter ersetzen, anstatt nur Platzhalter für die letzten beiden Ziffern zu verwenden.

```
arn:aws:s3:::examplebucket/my-data/sales-export-????-q?.*
arn:aws:s3:::examplebucket/my-data/sales-export-*-q?.*
```

Weitere Informationen zu S3-ARNs finden Sie unter[Festlegen von Ressourcen in einer Richtlinie](https://docs.aws.amazon.com//AmazonS3/latest/dev/s3-arn-format.html)und[Objektschlüssel und Metadaten](https://docs.aws.amazon.com//AmazonS3/latest/dev/UsingMetadata.html)im*Amazon-Simple-Storage-Service-Benutzerhandbuch*

# Amazon QuickSight -Ressourcen-ARNs
<a name="qs-resource-arns"></a>

Die folgenden Ressourcentypen werden von Amazon definiert QuickSight: Benutzer, Gruppe und Dashboard. Diese werden in Amazon verwendet QuickSight API-Aufrufe und als Elemente von IamPermission-Anweisungen. Zu findenup-to-date Informationen für Amazon QuickSight (Servicepräfix: quicksight) Ressourcen, Aktionen und Bedingungskontextschlüssel für die Verwendung in IAMPermission-Richtlinien finden Sie unter[Aktionen, Ressourcen und Bedingungsschlüssel für Amazon QuickSight](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html)im*IAM-Benutzerhandbuch.* 


| Ressourcentyp | ARN-Format | Bedingungsschlüssel | 
| --- | --- | --- | 
| user | arn: \$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1\$1\$1\$1\$1 \$1\$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1ResourceId\$1 | – | 
| Gruppe | arn: \$1 \$1\$1 \$1\$1\$1\$1 \$1\$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1\$1\$1 \$1\$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1ResourceId\$1 | – | 
| Dashboard | arn: \$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1\$1 \$1\$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1 \$1\$1ResourceId\$1 | – | 

Ressourcen-ARNs werden aus den Segmenten erstellt, die Ihre Ressource beschreiben. Beispielsweise besteht ein Ressourcen-ARN für eine Analyse aus den folgenden Segmenten. 

```
arn:<partition>:quicksight:<aws-region>:<aws-account-id>:<resource-type>/<resource-id>
```

Die Segmente sind wie folgt definiert:
+ *`partition`*— Beispiel,`aws`oder`aws-cn`.
+ *`aws-region`*— DieAWS-Regiondas enthält die Ressource. 
+ *`aws-account-id`*— DieAWS-Kontodas enthält die Ressource. Dies schließt die Bindestriche aus.
+ *`resource-type`*— Typ der Ressource In unserem Beispiel lautet diese`analyses`. Für ein Dashboard ist es`dashboard`.
+ *`resource-id`*— Die eindeutige Kennung für eine bestimmte Ressource.

DieAWS-Region, Ressourcentyp und Ressourcen-ID werden in der URL der Ressource identifiziert, wenn Sie Amazon verwenden QuickSight console. Angenommen, dies ist die URL der Analyse, für die Sie einen ARN benötigen.

```
https://us-east-2.quicksight.aws.amazon.com/sn/analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29
```

Das AWS-Region ist `us-east-2`. Der resource-type ist`analysis`. Die Ressourcen-ID in dieser URL lautet`4036e682-7de6-4c05-8a76-be51b9ec9b29`. Wenn Ihre -Kontonummer lautet`111122223333`, dann lautet der ARN für diese Analyse wie folgt.

```
arn:aws:quicksight:us-east-2:111122223333:analysis/4036e682-7de6-4c05-8a76-be51b9ec9b29
```

Um Ihre zu bekommenAWS-Kontowenden Sie sich an Ihren Systemadministrator