Exemples CodeArtifact avec l’AWS CLI

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec 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

Actions

L’exemple de code suivant montre comment utiliser associate-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, consultez Ajouter une connexion externe dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser copy-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, consultez Copie de packages entre des référentiels dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser create-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 Création d’un domaine dans le Guide de l’utilisateur AWSCodeArtifact.

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

L’exemple de code suivant montre comment utiliser create-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 Création d’un domaine dans le Guide de l’utilisateur AWSCodeArtifact.

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

L’exemple de code suivant montre comment utiliser delete-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 Suppression d’une politique de domaine dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser delete-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, consultez Suppression d’un domaine dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser delete-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, consultez Suppression d’une version de package dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser delete-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, consultez Suppression d’une politique dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser delete-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, consultez Suppression d’un référentiel dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser describe-domain.

AWS CLI

Pour obtenir des informations sur un domaine

L’exemple describe-domain suivant renvoie un objet DomainDescription 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 Présentation du domaine dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser describe-repository.

AWS CLI

Pour obtenir des informations sur un référentiel

L’exemple describe-repository suivant renvoie un objet RepositoryDescription 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 Création d’un domaine dans le Guide de l’utilisateur AWSCodeArtifact.

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

L’exemple de code suivant montre comment utiliser disassociate-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, consultez Suppression d’une connexion externe dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser dispose-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 Utilisation des packages dans CodeArtifact dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser get-authorization-token.

AWS CLI

Pour obtenir un jeton d’autorisation

L’exemple get-authorization-token suivant extrait un jeton d’autorisation CodeArtifact.


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, consultez Configuration de pip sans la commande de connexion dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser get-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, consultez Lecture d’une politique de domaine dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser get-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, consultez Liste des ressources de la version du package dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser get-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, consultez Affichage du fichier readme de la version du package dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser get-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 Connexion à un référentiel dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser get-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, consultez Lecture d’une politique dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser list-domains.

AWS CLI

Pour répertorier les domaines

L’exemple list-domains suivant renvoie un résumé de tous les domaines détenus par le compte AWS 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 Utilisation des domaines dans CodeArtifact dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser list-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, consultez Liste des ressources de la version du package dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser list-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, consultez Affichage et mise à jour des détails et des dépendances des versions de package dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser list-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, consultez Liste des versions de packages dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser list-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, consultez Liste des noms de packages dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser list-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, consultez Liste des référentiels dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser list-repositories.

AWS CLI

Pour répertorier les référentiels

L’exemple list-repositories suivant renvoie un résumé de tous les référentiels du domaine appartenant au compte AWS 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, consultez Liste des référentiels dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser login.

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 Premiers pas avec l’interface de ligne de commande AWS dans le Guide de l’utilisateur AWS CodeArtifact.

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 utiliser put-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, consultez Définition d’une politique de domaine dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser put-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, consultez Définition d’une politique dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser update-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 Mise à jour du statut de la version du package dans le Guide de l’utilisateur AWS CodeArtifact.

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

L’exemple de code suivant montre comment utiliser update-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, consultez Affichage ou modification d’une configuration de référentiel dans le Guide de l’utilisateur AWS CodeArtifact.

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

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

CloudWatch Synthetics

CodeBuild