View a markdown version of this page

CodeArtifact exemples utilisant AWS CLI - AWS Exemples de code SDK
Actions

D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples GitHub .

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

CodeArtifact exemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS Command Line Interface with CodeArtifact.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliserassociate-external-connection.

AWS CLI

Pour ajouter une connexion externe à un référentiel

L’exemple associate-external-connection suivant ajoute une connexion externe à npmjs.com à un référentiel nommé test-repo.

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

Sortie :

{
    "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"
            }
        ]
    }
}

Pour plus d'informations, voir Ajouter une connexion externe dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utilisercopy-package-versions.

AWS CLI

Pour copier des versions de package d’un référentiel vers un autre

Les copy-package-versions suivantes déplacent les versions 4.0.0 et 5.0.0 d’un package nommé test-package de my-repo vers test-repo.

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"]'

Sortie :

{
    "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"
        }
    ]
}

Pour plus d'informations, voir Copier des packages entre les référentiels dans le Guide de l'AWS CodeArtifact utilisateur.

  • Pour plus de détails sur l'API, consultez CopyPackageVersions la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-domain.

AWS CLI

Pour créer un domaine

L’exemple create-domain suivant crée un domaine nommé test-domain.

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

Sortie :

{
    "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
    }
}

Pour plus d'informations, consultez la section Créer un domaine dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, consultez CreateDomain la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-repository.

AWS CLI

Pour créer un référentiel

L’exemple create-repository suivant crée un référentiel nommé test-repo dans un domaine nommé test-domain.

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

Sortie :

{
    "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": []
    }
}

Pour plus d'informations, consultez la section Créer un domaine dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, consultez CreateRepository la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-domain-permissions-policy.

AWS CLI

Pour supprimer le document de politique d’autorisations d’un domaine

L’exemple delete-domain-permissions-policy suivant supprime la politique d’autorisation d’un domaine nommé test-domain.

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

Sortie :

{
    "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"
            }
        }
    ]
}

Pour plus d'informations, consultez la section Supprimer une politique de domaine dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserdelete-domain.

AWS CLI

Pour supprimer un domaine

L’exemple delete-domain suivant supprime un domaine nommé test-domain.

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

Sortie :

{
    "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
    }
}

Pour plus d'informations, voir Supprimer un domaine dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, consultez DeleteDomain la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-package-versions.

AWS CLI

Pour supprimer des versions de package

L’exemple delete-package-versions suivant supprime la version 4.0.0 d’un package nommé test-package.

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

Sortie :

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

Pour plus d'informations, voir Supprimer une version de package dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserdelete-repository-permissions-policy.

AWS CLI

Pour supprimer une politique d’autorisations d’un référentiel

L’exemple delete-repository-permissions-policy suivant supprime la politique d’autorisations d’un référentiel nommé test-repo.

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

Sortie :

{
    "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": "*"
        }
    ]
}

Pour plus d'informations, voir Supprimer une politique dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserdelete-repository.

AWS CLI

Pour supprimer un référentiel

L’exemple delete-repository suivant supprime un référentiel nommé test-repo dans un domaine nommé test-domain.

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

Sortie :

{
    "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": []
    }
}

Pour plus d'informations, voir Supprimer un référentiel dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, consultez DeleteRepository la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-domain.

AWS CLI

Pour obtenir des informations sur un domaine

L'describe-domainexemple suivant renvoie un DomainDescription objet pour un domaine nommé test-domain.

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

Sortie :

{
    "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"
    }
}

Pour plus d'informations, consultez la section Présentation du domaine dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, consultez DescribeDomain la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-repository.

AWS CLI

Pour obtenir des informations sur un référentiel

L'describe-repositoryexemple suivant renvoie un RepositoryDescription objet pour un référentiel nommé test-repo.

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

Sortie :

{
    "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": []
    }
}

Pour plus d'informations, consultez la section Créer un domaine dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, consultez DescribeRepository la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdisassociate-external-connection.

AWS CLI

Pour supprimer une connexion externe d’un référentiel

L’exemple disassociate-external-connection suivant supprime une connexion externe à npmjs.com d’un référentiel nommé test-repo.

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

Sortie :

{
    "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": []
    }
}

Pour plus d'informations, voir Supprimer une connexion externe dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserdispose-package-versions.

AWS CLI

Pour supprimer les actifs d’une version de package et définir son statut sur Disposed

L’exemple dispose-package-versions suivant supprime les actifs de la version 4.0.0 du package de test et définit son statut sur Disposed.

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

Sortie :

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

Pour plus d'informations, consultez la section Utilisation des packages CodeArtifact dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserget-authorization-token.

AWS CLI

Pour obtenir un jeton d’autorisation

L'get-authorization-tokenexemple suivant récupère un jeton d' CodeArtifact autorisation.

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

Sortie :

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

Pour plus d'informations, voir Configurer pip sans la commande login dans le Guide de l'AWS CodeArtifact utilisateur.

L'exemple de code suivant montre comment utiliserget-domain-permissions-policy.

AWS CLI

Pour obtenir le document de politique d’autorisations pour un domaine

L’exemple get-domain-permissions-policy suivant obtient la politique d’autorisations attachée à un domaine nommé test-domain.

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

Sortie :

{
    "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"
            }
        }
    ]
}

Pour plus d'informations, voir Lire une politique de domaine dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserget-package-version-asset.

AWS CLI

Pour obtenir un actif d’une version de package

L’exemple get-package-version-asset suivant extrait l’actif package.tgz pour la version 4.0.0 d’un package npm nommé test-package.

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

Sortie :

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="
}

Pour plus d'informations, voir Répertorier les actifs des versions des packages dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserget-package-version-readme.

AWS CLI

Pour obtenir le fichier readme d’une version de package

L’exemple get-package-version-readme suivant extrait le fichier readme pour la version 4.0.0 d’un package npm nommé test-package.

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

Sortie :

{
    "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="
}

Pour plus d'informations, voir Afficher le fichier readme de la version du package dans le Guide de l'AWS CodeArtifact utilisateur.

L'exemple de code suivant montre comment utiliserget-repository-endpoint.

AWS CLI

Pour obtenir le point de terminaison d’URL d’un référentiel

L’exemple get-repository-endpoint suivant renvoie le point de terminaison npm pour le référentiel test-repo.

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

Sortie :

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

Pour plus d'informations, consultez la section Connexion à un référentiel dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserget-repository-permissions-policy.

AWS CLI

Pour obtenir le document de politique d’autorisations pour un référentiel

L’exemple get-repository-permissions-policy suivant obtient la politique d’autorisations attachée à un référentiel nommé test-repo.

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

Sortie :

{
    "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": "*"
        }
    ]
}

Pour plus d'informations, voir Lire une politique dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserlist-domains.

AWS CLI

Pour répertorier les domaines

L'list-domainsexemple suivant renvoie un résumé de tous les domaines détenus par le AWS compte qui effectue l'appel.

aws codeartifact list-domains

Sortie :

{
    "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"
        }
    ]
}

Pour plus d'informations, consultez la section Utilisation des domaines CodeArtifact dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, consultez ListDomains la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-package-version-assets.

AWS CLI

Pour afficher les actifs d’une version de package

L’exemple list-package-version-assets suivant extrait les actifs de la version 4.0.0 d’un package npm nommé test-package.

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

Sortie :

{
    "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"
            }
        }
    ]
}

Pour plus d'informations, voir Répertorier les actifs des versions des packages dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserlist-package-version-dependencies.

AWS CLI

Pour afficher les dépendances d’une version de package

L’exemple list-package-version-dependencies suivant extrait les dépendances de la version 4.0.0 d’un package npm nommé test-package.

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

Sortie :

{
    "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"
        }
    ]
}

Pour plus d'informations, voir Afficher et mettre à jour les détails et les dépendances de la version du package dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserlist-package-versions.

AWS CLI

Pour répertorier les versions d’un package

L’exemple list-package-versions suivant renvoie une liste des versions de package pour un package nommé kind-of.

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

Sortie :

{
    "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"
        }
    ]
}

Pour plus d'informations, voir Répertorier les versions des packages dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, consultez ListPackageVersions la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-packages.

AWS CLI

Pour répertorier les packages dans un référentiel

L’exemple list-packages suivant répertorie les packages d’un référentiel nommé test-repo dans un domaine nommé test-domain.

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

Sortie :

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

Pour plus d'informations, voir Répertorier les noms des packages dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, consultez ListPackages la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-repositories-in-domain.

AWS CLI

Pour répertorier les référentiels d’un domaine

L’exemple list-repositories-in-domain suivant renvoie un résumé de tous les référentiels du domaine test-domain.

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

Sortie :

{
    "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."
        }
    ]
}

Pour plus d'informations, voir Répertorier les référentiels dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserlist-repositories.

AWS CLI

Pour répertorier les référentiels

L'list-repositoriesexemple suivant renvoie un résumé de tous les référentiels du domaine appartenant au AWS compte qui effectue l'appel.

aws codeartifact list-repositories

Sortie :

{
    "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."
        }
    ]
}

Pour plus d'informations, voir Répertorier les référentiels dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, consultez ListRepositories la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlogin.

AWS CLI

Pour configurer l’authentification auprès de votre référentiel à l’aide de la commande de connexion

L’exemple login suivant configure le gestionnaire de packages npm avec un référentiel nommé test-repo dans un domaine nommé test-domain.

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

Sortie :

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

Pour plus d'informations, consultez la section Démarrage avec l' AWS interface de ligne de commande dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l’API, consultez Login dans la Référence des commandes de l’AWS CLI .

L'exemple de code suivant montre comment utiliserput-domain-permissions-policy.

AWS CLI

Pour attacher une politique d’autorisations à un domaine

L’exemple put-domain-permissions-policy suivant attache une politique d’autorisations définie dans le fichier policy.json à un domaine nommé test-domain.

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

Sortie :

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

Pour plus d'informations, voir Définir une politique de domaine dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserput-repository-permissions-policy.

AWS CLI

Pour attacher une politique d’autorisations à un référentiel

L’exemple put-repository-permissions-policy suivant attache une politique d’autorisations définie dans le fichier policy.json à un référentiel nommé test-repo.

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

Sortie :

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

Pour plus d'informations, voir Définir une politique dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserupdate-package-versions-status.

AWS CLI

Pour mettre à jour le statut de la version du package

L’exemple update-package-versions-status suivant met à jour le statut de la version 4.0.0 du package test-package sur Archived.

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

Sortie :

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

Pour plus d'informations, consultez la section Mettre à jour l'état de la version du package dans le Guide de AWS CodeArtifact l'utilisateur.

L'exemple de code suivant montre comment utiliserupdate-repository.

AWS CLI

Pour mettre à jour un référentiel

L’exemple update-repository suivant met à jour la description d’un référentiel nommé test-repo dans un domaine nommé test-domain en « ceci est une description mise à jour ».

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

Sortie :

{
    "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": []
    }
}

Pour plus d'informations, voir Afficher ou modifier la configuration d'un référentiel dans le Guide de AWS CodeArtifact l'utilisateur.

  • Pour plus de détails sur l'API, consultez UpdateRepository la section Référence des AWS CLI commandes.