Beispiele für die Verwendung der AWS CLI mit CodeArtifact - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung der AWS CLI mit CodeArtifact

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit CodeArtifact nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie associate-external-connection verwendet wird.

AWS CLI

So fügen Sie einem Repository eine externe Verbindung hinzu

Das folgende associate-external-connection-Beispiel fügt einem Repository namens „test-repo“ eine externe Verbindung mit „npmjs.com“ hinzu.

aws codeartifact associate-external-connection \
    --repository test-repo \
    --domain test-domain \
    --external-connection public:npmjs

Ausgabe:

{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "upstreams": [],
        "externalConnections": [
            {
                "externalConnectionName": "public:npmjs",
                "packageFormat": "npm",
                "status": "AVAILABLE"
            }
        ]
    }
}

Weitere Informationen finden Sie unter Hinzufügen einer externen Verbindung im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie copy-package-versions verwendet wird.

AWS CLI

So kopieren Sie Paketversionen aus einem Repository in ein anderes

Mit dem folgenden copy-package-versions-Befehl werden die Versionen 4.0.0 und 5.0.0 eines Pakets namens „test-package“ von „my-repo“ nach „test-repo“ verschoben.

aws codeartifact copy-package-versions \
    --domain test-domain \
    --source-repository my-repo \
    --destination-repository test-repo \
    --format npm \
    --package test-package \
    --versions '["4.0.0", "5.0.0"]'

Ausgabe:

{
    "format": "npm",
    "package": "test-package",
    "versions": [
        {
        "version": "5.0.0",
        "revision": "REVISION-1-SAMPLE-6C81EFF7DA55CC",
        "status": "Published"
        },
        {
        "version": "4.0.0",
        "revision": "REVISION-2-SAMPLE-55C752BEE772FC",
        "status": "Published"
        }
    ]
}

Weitere Informationen finden Sie unter Kopieren von Paketen zwischen Repositorys im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie create-domain verwendet wird.

AWS CLI

So erstellen Sie eine Domain

Im folgenden create-domain-Beispiel wird eine Domain namens „my-domain“ erstellt.

aws codeartifact create-domain \
    --domain test-domain

Ausgabe:

{
    "domain": {
        "name": "test-domain",
        "owner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/test-domain",
        "status": "Active",
        "createdTime": "2020-10-20T13:16:48.559000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryCount": 0,
        "assetSizeBytes": 0
    }
}

Weitere Informationen finden Sie unter Erstellen einer Domain im Benutzerhandbuch zu AWS CodeArtifact.

  • API-Details finden Sie unter CreateDomain in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-repository verwendet wird.

AWS CLI

So erstellen Sie ein Repository

Im folgenden create-repository-Beispiel wird ein Repository mit dem Namen „test-repo“ in der Domain „test-domain“ erstellt.

aws codeartifact create-repository \
    --domain test-domain \
    --domain-owner 111122223333 \
    --repository test-repo \
    --description "This is a test repository."

Ausgabe:

{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "description": "This is a test repository.",
        "upstreams": [],
        "externalConnections": []
    }
}

Weitere Informationen finden Sie unter Erstellen einer Domain im Benutzerhandbuch zu AWS CodeArtifact..

Das folgende Codebeispiel zeigt, wie delete-domain-permissions-policy verwendet wird.

AWS CLI

So löschen Sie das Dokument mit den Berechtigungsrichtlinien aus einer Domain

Im folgenden delete-domain-permissions-policy-Beispiel wird die Berechtigungsrichtlinie aus einer Domain mit dem Namen „test-domain“ gelöscht.

aws codeartifact delete-domain-permissions-policy \
    --domain test-domain

Ausgabe:

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "BasicDomainPolicy",
            "Action": [
                "codeartifact:GetDomainPermissionsPolicy",
                "codeartifact:ListRepositoriesInDomain",
                "codeartifact:GetAuthorizationToken",
                "codeartifact:CreateRepository"
            ],
            "Effect": "Allow",
            "Resource": "*",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            }
        }
    ]
}

Weitere Informationen finden Sie unter Löschen einer Domainrichtlinie im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie delete-domain verwendet wird.

AWS CLI

So löschen Sie eine Domain

Im folgenden delete-domain-Beispiel wird eine Domain namens test-domain gelöscht.

aws codeartifact delete-domain \
    --domain test-domain

Ausgabe:

{
    "domain": {
        "name": "test-domain",
        "owner": "417498243647",
        "arn": "arn:aws:codeartifact:us-west-2:417498243647:domain/test-domain",
        "status": "Deleted",
        "createdTime": "2020-10-20T13:16:48.559000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:417498243647:key/c9fe2447-0795-4fda-afbe-8464574ae162",
        "repositoryCount": 0,
        "assetSizeBytes": 0
    }
}

Weitere Informationen finden Sie unter Löschen einer Domain im Benutzerhandbuch zu AWS CodeArtifact.

  • API-Details finden Sie unter DeleteDomain in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-package-versions verwendet wird.

AWS CLI

So löschen Sie Paketversionen

Im folgenden delete-package-versions-Beispiel wird Version 4.0.0 eines Pakets namens „test-package“ gelöscht.

aws codeartifact delete-package-versions \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --versions 4.0.0

Ausgabe:

{
    "successfulVersions": {
        "4.0.0": {
            "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
            "status": "Deleted"
        }
    },
    "failedVersions": {}
}

Weitere Informationen finden Sie unter Löschen einer Paketversion im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie delete-repository-permissions-policy verwendet wird.

AWS CLI

So löschen Sie eine Berechtigungsrichtlinie aus einem Repository

Im folgenden delete-repository-permissions-policy-Beispiel wird die Berechtigungsrichtlinie aus einem Repository mit dem Namen „test-repo“ gelöscht.

aws codeartifact delete-repository-permissions-policy \
    --domain test-domain \
    --repository test-repo

Ausgabe:

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            },
            "Action": [
                "codeartifact:DescribePackageVersion",
                "codeartifact:DescribeRepository",
                "codeartifact:GetPackageVersionReadme",
                "codeartifact:GetRepositoryEndpoint",
                "codeartifact:ListPackages",
                "codeartifact:ListPackageVersions",
                "codeartifact:ListPackageVersionAssets",
                "codeartifact:ListPackageVersionDependencies",
                "codeartifact:ReadFromRepository"
            ],
            "Resource": "*"
        }
    ]
}

Weitere Informationen finden Sie unter Löschen einer Richtlinie im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie delete-repository verwendet wird.

AWS CLI

So löschen Sie ein Repository

Im folgenden delete-repository-Beispiel wird ein Repository mit dem Namen test-repo in der Domain test-domain gelöscht.

aws codeartifact delete-repository \
    --domain test-domain \
    --repository test-repo

Ausgabe:

{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "description": "This is a test repository",
        "upstreams": [],
        "externalConnections": []
    }
}

Weitere Informationen finden Sie unter Löschen eines Repositorys im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie describe-domain verwendet wird.

AWS CLI

So rufen Sie Informationen zu einer Domain ab

Im folgenden describe-domain-Beispiel wird ein DomainDescription-Objekt für eine Domain namens „test-domain“ zurückgegeben.

aws codeartifact describe-domain \
    --domain test-domain

Ausgabe:

{
    "domain": {
        "name": "test-domain",
        "owner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:domain/test-domain",
        "status": "Active",
        "createdTime": "2020-10-20T13:16:48.559000-04:00",
        "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryCount": 2,
        "assetSizeBytes": 0,
        "s3BucketArn": "arn:aws:s3:::assets-111122223333-us-west-2"
    }
}

Weitere Informationen finden Sie unter Übersicht über die Domain im Benutzerhandbuch zu AWS CodeArtifact.

  • API-Details finden Sie unter DescribeDomain in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-repository verwendet wird.

AWS CLI

So rufen Sie Informationen zu einem Repository ab

Im folgenden describe-repository-Beispiel wird ein RepositoryDescription-Objekt für ein Repository mit dem Namen „test-repo“ zurückgegeben.

aws codeartifact describe-repository \
    --domain test-domain \
    --repository test-repo

Ausgabe:

{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "description": "This is a test repository.",
        "upstreams": [],
        "externalConnections": []
    }
}

Weitere Informationen finden Sie unter Erstellen einer Domain im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie disassociate-external-connection verwendet wird.

AWS CLI

So entfernen Sie eine externe Verbindung aus einem Repository

Im folgenden disassociate-external-connection-Beispiel wird eine externe Verbindung mit „npmjs.com“ aus einem Repository namens „test-repo“ entfernt.

aws codeartifact disassociate-external-connection \
    --repository test-repo \
    --domain test-domain \
    --external-connection public:npmjs

Ausgabe:

{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "upstreams": [],
        "externalConnections": []
    }
}

Weitere Informationen finden Sie unter Entfernen einer externen Verbindung im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie dispose-package-versions verwendet wird.

AWS CLI

So löschen Sie die Assets einer Paketversion und legen ihren Status auf „Entsorgt“ fest

Im folgenden dispose-package-versions-Beispiel werden die Assets der „test-package“-Version 4.0.0 gelöscht und ihr Status auf „Entsorgt“ gesetzt.

aws codeartifact dispose-package-versions \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --versions 4.0.0

Ausgabe:

{
    "successfulVersions": {
        "4.0.0": {
            "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
            "status": "Disposed"
        }
    },
    "failedVersions": {}
}

Weitere Informationen finden Sie Arbeiten mit Paketen in CodeArtifact im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie get-authorization-token verwendet wird.

AWS CLI

So rufen Sie ein Autorisierungstoken ab

Im folgenden Beispiel für get-authorization-token wird ein CodeArtifact-Autorisierungstoken abgerufen.

aws codeartifact get-authorization-token \
    --domain test-domain \
    --query authorizationToken \
    --output text

Ausgabe:

This command will return the authorization token. You can store the output in an environment variable when calling the command.

Weitere Informationen finden Sie unter Konfigurieren von pip ohne Anmeldebefehl im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie get-domain-permissions-policy verwendet wird.

AWS CLI

So rufen Sie das Dokument mit den Berechtigungsrichtlinien für eine Domain ab

Im folgenden get-domain-permissions-policy-Beispiel wird die Berechtigungsrichtlinie abgerufen, die einer Domain mit dem Namen „test-domain“ angefügt ist.

aws codeartifact get-domain-permissions-policy \
    --domain test-domain

Ausgabe:

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "BasicDomainPolicy",
            "Action": [
                "codeartifact:GetDomainPermissionsPolicy",
                "codeartifact:ListRepositoriesInDomain",
                "codeartifact:GetAuthorizationToken",
                "codeartifact:CreateRepository"
            ],
            "Effect": "Allow",
            "Resource": "*",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            }
        }
    ]
}

Weitere Informationen finden Sie unter Lesen einer Domainrichtlinie im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie get-package-version-asset verwendet wird.

AWS CLI

So rufen Sie ein Asset aus einer Paketversion ab

Im folgenden get-package-version-asset-Beispiel wird das package.tgz-Asset für Version 4.0.0 eines npm-Pakets namens „test-package“ abgerufen.

aws codeartifact get-package-version-asset \
    --domain test-domain \
    --repository test-repo \
    --format npm \
    --package test-package \
    --package-version 4.0.0 \
    --asset 'package.tgz' \
    outfileName

Ausgabe:

The output for this command will also store the raw asset in the file provided in place of outfileName.

{
    "assetName": "package.tgz",
    "packageVersion": "4.0.0",
    "packageVersionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs="
}

Weitere Informationen finden Sie unter Auflisten der Assets einer Paketversion im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie get-package-version-readme verwendet wird.

AWS CLI

So rufen Sie die Readme-Datei einer Paketversion ab

Im folgenden get-package-version-readme-Beispiel wird die Readme-Datei für Version 4.0.0 eines npm-Pakets namens „test-package“ abgerufen.

aws codeartifact get-package-version-readme \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --package-version 4.0.0

Ausgabe:

{
    "format": "npm",
    "package": "test-package",
    "version": "4.0.0",
    "readme": "<div align=\"center\">\n   <a href=\https://github.com/test-package/testpack\"> ... more content ... \n",
    "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs="
}

Weitere Informationen finden Sie unter Anzeigen der Readme-Datei einer Paketversion im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie get-repository-endpoint verwendet wird.

AWS CLI

So rufen Sie den URL-Endpunkt eines Repositorys ab

Das folgende get-repository-endpoint-Beispiel gibt den NPM-Endpunkt für das Repository „test-repo“ zurück.

aws codeartifact get-repository-endpoint \
    --domain test-domain \
    --repository test-repo \
    --format npm

Ausgabe:

{
    "repositoryEndpoint": "https://test-domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/npm/test-repo/"
}

Weitere Informationen finden Sie unter Herstellen einer Verbindung mit einem Repository im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie get-repository-permissions-policy verwendet wird.

AWS CLI

So rufen Sie das Dokument mit den Berechtigungsrichtlinien für ein Repository ab

Im folgenden get-repository-permissions-policy-Beispiel wird die Berechtigungsrichtlinie abgerufen, die einem Repository mit dem Namen „test-repo“ angefügt ist.

aws codeartifact get-repository-permissions-policy \
    --domain test-domain \
    --repository test-repo

Ausgabe:

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            },
            "Action": [
                "codeartifact:DescribePackageVersion",
                "codeartifact:DescribeRepository",
                "codeartifact:GetPackageVersionReadme",
                "codeartifact:GetRepositoryEndpoint",
                "codeartifact:ListPackages",
                "codeartifact:ListPackageVersions",
                "codeartifact:ListPackageVersionAssets",
                "codeartifact:ListPackageVersionDependencies",
                "codeartifact:ReadFromRepository"
            ],
            "Resource": "*"
        }
    ]
}

Weitere Informationen finden Sie unter Lesen einer Richtlinie im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie list-domains verwendet wird.

AWS CLI

So listen Sie Domains auf

Das folgende list-domains-Beispiel gibt eine Zusammenfassung aller Domains zurück, die dem aufrufenden AWS-Konto gehören.

aws codeartifact list-domains

Ausgabe:

{
    "domains": [
        {
            "name": "my-domain",
            "owner": "111122223333",
            "status": "Active",
            "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
        },
        {
            "name": "test-domain",
            "owner": "111122223333",
            "status": "Active",
            "encryptionKey": "arn:aws:kms:us-west-2:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
        }
    ]
}

Weitere Informationen finden Sie Arbeiten mit Domains in CodeArtifact im Benutzerhandbuch zu AWS CodeArtifact.

  • API-Details finden Sie unter ListDomains in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-package-version-assets verwendet wird.

AWS CLI

So zeigen Sie die Assets einer Paketversion an

Im folgenden list-package-version-assets-Beispiel werden die Assets für Version 4.0.0 eines npm-Pakets namens „test-package“ abgerufen.

aws codeartifact list-package-version-assets \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --package-version 4.0.0

Ausgabe:

{
    "format": "npm",
    "package": "test-package",
    "version": "4.0.0",
    "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
    "assets": [
        {
            "name": "package.tgz",
            "size": 316680,
            "hashes": {
                "MD5": "60078ec6d9e76b89fb55c860832742b2",
                "SHA-1": "b44a9b6297bcb698f1c51a3545a2b3b368d59c52",
                "SHA-256": "d2aa8c6afc3c8591765785a37d1c5acae482a8eb3ab9729ed28922692454f2e2",
                "SHA-512": "3e585d15c8a594e20d7de57b362ea81754c011acb2641a19f1b72c8531ea39825896bab344ae616a0a5a824cb9a381df0b3cddd534645cf305aba70a93dac698"
            }
        }
    ]
}

Weitere Informationen finden Sie unter Auflisten der Assets einer Paketversion im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie list-package-version-dependencies verwendet wird.

AWS CLI

So zeigen Sie die Abhängigkeiten einer Paketversion an

Im folgenden list-package-version-dependencies-Beispiel werden die Abhängigkeiten für Version 4.0.0 eines npm-Pakets namens „test-package“ abgerufen.

aws codeartifact list-package-version-dependencies \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --package-version 4.0.0

Ausgabe:

{
    "format": "npm",
    "package": "test-package",
    "version": "4.0.0",
    "versionRevision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
    "dependencies": [
        {
            "namespace": "testns",
            "package": "testdep1",
            "dependencyType": "regular",
            "versionRequirement": "1.8.5"
        },
        {
            "namespace": "testns",
            "package": "testdep2",
            "dependencyType": "regular",
            "versionRequirement": "1.8.5"
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen und Aktualisieren der Details und Abhängigkeiten einer Paketversion im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie list-package-versions verwendet wird.

AWS CLI

So listen Sie Paketversionen für ein Paket auf

Das folgende list-package-versions-Beispiel gibt eine Liste von Paketversionen für ein Paket mit dem Namen kind-of zurück.

aws codeartifact list-package-versions \
    --package kind-of \
    --domain test-domain \
    --repository test-repo \
    --format npm

Ausgabe:

{
    "defaultDisplayVersion": "1.0.1",
    "format": "npm",
    "package": "kind-of",
    "versions": [
        {
            "version": "1.0.1",
            "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC",
            "status": "Published"
        },
        {
            "version": "1.0.0",
            "revision": "REVISION-SAMPLE-2-C752BEEF6D2CFC",
            "status": "Published"
        },
        {
            "version": "0.1.2",
            "revision": "REVISION-SAMPLE-3-654S65A5C5E1FC",
            "status": "Published"
        },
        {
            "version": "0.1.1",
            "revision": "REVISION-SAMPLE-1-C7F4S5E9B772FC"",
            "status": "Published"
        },
        {
            "version": "0.1.0",
            "revision": "REVISION-SAMPLE-4-AF669139B772FC",
            "status": "Published"
        }
    ]
}

Weitere Informationen finden Sie unter Auflisten von Paketversionen im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie list-packages verwendet wird.

AWS CLI

So listen Sie Pakete in einem Repository auf

Im folgenden list-packages-Beispiel werden Pakete in einem Repository mit dem Namen test-repo in der Domain test-domain aufgelistet.

aws codeartifact list-packages \
    --domain test-domain \
    --repository test-repo

Ausgabe:

{
    "packages": [
        {
            "format": "npm",
            "package": "lodash"
        }
        {
            "format": "python",
            "package": "test-package"
        }
    ]
}

Weitere Informationen finden Sie unter Auflisten von Paketnamen im Benutzerhandbuch zu AWS CodeArtifact.

  • API-Details finden Sie unter ListPackages in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-repositories-in-domain verwendet wird.

AWS CLI

So listen Sie Repositorys in einer Domain auf

Das folgende list-repositories-in-domain-Beispiel gibt eine Zusammenfassung aller Repositorys in der Domain „test-domain“ zurück.

aws codeartifact list-repositories-in-domain \
    --domain test-domain

Ausgabe:

{
    "repositories": [
        {
            "name": "test-repo",
            "administratorAccount": "111122223333",
            "domainName": "test-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
            "description": "This is a test repository."
        },
        {
            "name": "test-repo2",
            "administratorAccount": "111122223333",
            "domainName": "test-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo2",
            "description": "This is a test repository."
        }
    ]
}

Weitere Informationen finden Sie unter Auflisten von Repositorys im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie list-repositories verwendet wird.

AWS CLI

So listen Sie Repositorys auf

Das folgende list-repositories-Beispiel gibt eine Zusammenfassung aller Repositorys in einer Domain zurück, die dem aufrufenden AWS-Konto gehört.

aws codeartifact list-repositories

Ausgabe:

{
    "repositories": [
        {
            "name": "npm-store",
            "administratorAccount": "111122223333",
            "domainName": "my-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/npm-store",
            "description": "Provides npm artifacts from npm, Inc."
        },
        {
            "name": "target-repo",
            "administratorAccount": "111122223333",
            "domainName": "my-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/my-domain/target-repo",
            "description": "test target repo"
        },
        {
            "name": "test-repo2",
            "administratorAccount": "111122223333",
            "domainName": "test-domain",
            "domainOwner": "111122223333",
            "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo2",
            "description": "This is a test repository."
        }
    ]
}

Weitere Informationen finden Sie unter Auflisten von Repositorys im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie login verwendet wird.

AWS CLI

So konfigurieren Sie die Authentifizierung für Ihr Repository mit dem Anmeldebefehl

Im folgenden login-Beispiel wird der npm-Paketmanager mit einem Repository mit dem Namen „test-repo“ in der Domain „test-domain“ konfiguriert.

aws codeartifact login \
    --domain test-domain \
    --repository test-repo \
    --tool npm

Ausgabe:

Successfully configured npm to use AWS CodeArtifact repository https://test-domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/npm/test-repo/
Login expires in 12 hours at 2020-11-12 01:53:16-05:00

Weitere Informationen finden Sie unter Erste Schritte mit AWS CLI im Benutzerhandbuch zu AWS CodeArtifact.

  • API-Details finden Sie unter Login in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie put-domain-permissions-policy verwendet wird.

AWS CLI

So fügen Sie eine Berechtigungsrichtlinie an eine Domain an

Im folgenden put-domain-permissions-policy-Beispiel wird eine Berechtigungsrichtlinie, die in der Datei „policy.json“ definiert ist, an eine Domain mit dem Namen „test-domain“ angefügt.

aws codeartifact put-domain-permissions-policy \
    --domain test-domain \
    --policy-document file://PATH/TO/policy.json

Ausgabe:

{
    "policy": {
        "resourceArn": "arn:aws:codeartifact:region-id:111122223333:domain/test-domain",
        "document": "{ ...policy document content...}",
        "revision": "MQlyyTQRASRU3HB58gBtSDHXG7Q3hvxxxxxxx="
    }
}

Weitere Informationen finden Sie unter Einrichten einer Domainrichtlinie im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie put-repository-permissions-policy verwendet wird.

AWS CLI

So fügen Sie eine Berechtigungsrichtlinie an ein Repository an

Im folgenden put-repository-permissions-policy-Beispiel wird eine Berechtigungsrichtlinie, die in der Datei „policy.json“ definiert ist, an ein Repository mit dem Namen „test-repo“ angefügt.

aws codeartifact put-repository-permissions-policy \
    --domain test-domain \
    --repository test-repo \
    --policy-document file://PATH/TO/policy.json

Ausgabe:

{
    "policy": {
        "resourceArn": "arn:aws:codeartifact:region-id:111122223333:repository/test-domain/test-repo",
        "document": "{ ...policy document content...}",
        "revision": "MQlyyTQRASRU3HB58gBtSDHXG7Q3hvxxxxxxx="
    }
}

Weitere Informationen finden Sie unter Einrichten einer Richtlinie im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie update-package-versions-status verwendet wird.

AWS CLI

So aktualisieren Sie den Status der Paketversion

Im folgenden update-package-versions-status-Beispiel wird der Status von Version 4.0.0 des Pakets „test-package“ auf „Archiviert“ aktualisiert.

aws codeartifact update-package-versions-status \
    --domain test-domain \
    --repo test-repo \
    --format npm \
    --package test-package \
    --versions 4.0.0 \
    --target-status Archived

Ausgabe:

{
    "successfulVersions": {
        "4.0.0": {
            "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
            "status": "Archived"
        }
    },
    "failedVersions": {}
}

Weitere Informationen finden Sie unter Aktualisieren des Status einer Paketversion im Benutzerhandbuch zu AWS CodeArtifact.

Das folgende Codebeispiel zeigt, wie update-repository verwendet wird.

AWS CLI

So aktualisieren Sie ein Repository

Im folgenden update-repository-Beispiel wird die Beschreibung eines Repositorys mit dem Namen „test-repo“ in der Domain „test-domain“ auf „this is an updated description“ aktualisiert.

aws codeartifact update-repository \
    --domain test-domain \
    --repository test-repo \
    --description "this is an updated description"

Ausgabe:

{
    "repository": {
        "name": "test-repo",
        "administratorAccount": "111122223333",
        "domainName": "test-domain",
        "domainOwner": "111122223333",
        "arn": "arn:aws:codeartifact:us-west-2:111122223333:repository/test-domain/test-repo",
        "description": "this is an updated description",
        "upstreams": [],
        "externalConnections": []
    }
}

Weitere Informationen finden Sie unter Anzeigen und Modifizieren einer Repository-Konfiguration im Benutzerhandbuch zu AWS CodeArtifact.