# Ejemplos de CodeArtifact que utilizan la AWS CLI
<a name="cli_codeartifact_code_examples"></a>

En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar situaciones comunes mediante la AWS Command Line Interface con CodeArtifact.

Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

**Topics**
+ [Acciones](#actions)

## Acciones
<a name="actions"></a>

### `associate-external-connection`
<a name="codeartifact_AssociateExternalConnection_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `associate-external-connection`.

**AWS CLI**  
**Adición de una conexión externa a un repositorio**  
En el siguiente ejemplo de `associate-external-connection`, se agrega una conexión externa a npmjs.com a un repositorio denominado test-repo.  

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

```
{
    "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"
            }
        ]
    }
}
```
Para obtener más información, consulte [Add an external connection](https://docs.aws.amazon.com/codeartifact/latest/ug/external-connection.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [AssociateExternalConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/associate-external-connection.html) en la *Referencia de comandos de la AWS CLI*. 

### `copy-package-versions`
<a name="codeartifact_CopyPackageVersions_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `copy-package-versions`.

**AWS CLI**  
**Copia de versiones de un paquete de un repositorio a otro**  
En el siguiente ejemplo de `copy-package-versions`, se mueven las versiones 4.0.0 y 5.0.0 de un paquete denominado test-package de my-repo a 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"]'
```
Salida:  

```
{
    "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"
        }
    ]
}
```
Para obtener más información, consulte [Copy packages between repositories](https://docs.aws.amazon.com/codeartifact/latest/ug/copy-package.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener detalles sobre la API, consulte [CopyPackageVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/copy-package-versions.html) en la *Referencia de comandos de la AWS CLI*. 

### `create-domain`
<a name="codeartifact_CreateDomain_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-domain`.

**AWS CLI**  
**Creación de un dominio**  
En el siguiente ejemplo de `create-domain`, se crea un dominio denominado test-domain.  

```
aws codeartifact create-domain \
    --domain test-domain
```
Salida:  

```
{
    "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
    }
}
```
Para obtener más información, consulte [Create a domain](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-create.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [CreateDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/create-domain.html) en la *Referencia de comandos de la AWS CLI*. 

### `create-repository`
<a name="codeartifact_CreateRepository_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-repository`.

**AWS CLI**  
**Creación de un repositorio**  
En el siguiente ejemplo de `create-repository`, se crea un repositorio denominado test-repo dentro de un dominio denominado test-domain.  

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

```
{
    "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": []
    }
}
```
Para obtener más información, consulte [Create a domain](https://docs.aws.amazon.com/codeartifact/latest/ug/create-repo.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [CreateRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/create-repository.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-domain-permissions-policy`
<a name="codeartifact_DeleteDomainPermissionsPolicy_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-domain-permissions-policy`.

**AWS CLI**  
**Eliminación del documento de política de permisos de un dominio**  
En el siguiente ejemplo de `delete-domain-permissions-policy`, se elimina la política de permisos de un dominio denominado test-domain.  

```
aws codeartifact delete-domain-permissions-policy \
    --domain test-domain
```
Salida:  

```
{
    "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"
            }
        }
    ]
}
```
Para obtener más información, consulte [Delete a domain policy](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-policies.html#deleting-a-domain-policy) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [DeleteDomainPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-domain-permissions-policy.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-domain`
<a name="codeartifact_DeleteDomain_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-domain`.

**AWS CLI**  
**Eliminación de un dominio**  
En el siguiente ejemplo de `delete-domain`, se elimina un dominio denominado `test-domain`.  

```
aws codeartifact delete-domain \
    --domain test-domain
```
Salida:  

```
{
    "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
    }
}
```
Para obtener más información, consulte [Delete a domain](https://docs.aws.amazon.com/codeartifact/latest/ug/delete-domain.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [DeleteDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-domain.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-package-versions`
<a name="codeartifact_DeletePackageVersions_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-package-versions`.

**AWS CLI**  
**Eliminación de versiones de un paquete**  
En el siguiente ejemplo de `delete-package-versions`, se elimina la versión 4.0.0 de un paquete denominado test-package.  

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

```
{
    "successfulVersions": {
        "4.0.0": {
            "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
            "status": "Deleted"
        }
    },
    "failedVersions": {}
}
```
Para obtener más información, consulte [Delete a package version](https://docs.aws.amazon.com/codeartifact/latest/ug/delete-package.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [DeletePackageVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-package-versions.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-repository-permissions-policy`
<a name="codeartifact_DeleteRepositoryPermissionsPolicy_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-repository-permissions-policy`.

**AWS CLI**  
**Eliminación de una política de permisos de un repositorio**  
En el siguiente ejemplo de `delete-repository-permissions-policy`, se elimina la política de permisos de un repositorio denominado test-repo.  

```
aws codeartifact delete-repository-permissions-policy \
    --domain test-domain \
    --repository test-repo
```
Salida:  

```
{
    "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": "*"
        }
    ]
}
```
Para obtener más información, consulte [Delete a policy](https://docs.aws.amazon.com/codeartifact/latest/ug/repo-policies.html#deleting-a-policy) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [DeleteRepositoryPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-repository-permissions-policy.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-repository`
<a name="codeartifact_DeleteRepository_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-repository`.

**AWS CLI**  
**Eliminación de un repositorio**  
En el siguiente ejemplo de `delete-repository`, se elimina un repositorio denominado `test-repo` de un dominio denominado `test-domain`.  

```
aws codeartifact delete-repository \
    --domain test-domain \
    --repository test-repo
```
Salida:  

```
{
    "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": []
    }
}
```
Para obtener más información, consulte [Delete a repository](https://docs.aws.amazon.com/codeartifact/latest/ug/delete-repo.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [DeleteRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/delete-repository.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-domain`
<a name="codeartifact_DescribeDomain_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `describe-domain`.

**AWS CLI**  
**Para obtener información acerca de un dominio**  
En el siguiente ejemplo de `describe-domain`, se obtiene un objeto DomainDescription de un dominio denominado test-domain.  

```
aws codeartifact describe-domain \
    --domain test-domain
```
Salida:  

```
{
    "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"
    }
}
```
Para obtener más información, consulte [Domain overview](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-overview.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener más información sobre la API, consulte [DescribeDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/describe-domain.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-repository`
<a name="codeartifact_DescribeRepository_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `describe-repository`.

**AWS CLI**  
**Obtención de información sobre un repositorio**  
En el siguiente ejemplo de `describe-repository`, se obtiene un objeto RepositoryDescription de un repositorio denominado test-repo.  

```
aws codeartifact describe-repository \
    --domain test-domain \
    --repository test-repo
```
Salida:  

```
{
    "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": []
    }
}
```
Para obtener más información, consulte [Create a domain](https://docs.aws.amazon.com/codeartifact/latest/ug/create-repo.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [DescribeRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/describe-repository.html) en la *Referencia de comandos de la AWS CLI*. 

### `disassociate-external-connection`
<a name="codeartifact_DisassociateExternalConnection_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `disassociate-external-connection`.

**AWS CLI**  
**Eliminación de una conexión externa de un repositorio**  
En el siguiente ejemplo de `disassociate-external-connection`, se elimina una conexión externa a npmjs.com de un repositorio denominado test-repo.  

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

```
{
    "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": []
    }
}
```
Para obtener más información, consulte [Remove an external connection](https://docs.aws.amazon.com/codeartifact/latest/ug/external-connection.html#removing-an-external-connection) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [DisassociateExternalConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/disassociate-external-connection.html) en la *Referencia de comandos de la AWS CLI*. 

### `dispose-package-versions`
<a name="codeartifact_DisposePackageVersions_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `dispose-package-versions`.

**AWS CLI**  
**Eliminación de los activos de la versión de un paquete y establecimiento del estado en Disposed**  
En el siguiente ejemplo de `dispose-package-versions`, se eliminan los activos de la versión 4.0.0 de test-package y se establece su estado en Disposed.  

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

```
{
    "successfulVersions": {
        "4.0.0": {
            "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
            "status": "Disposed"
        }
    },
    "failedVersions": {}
}
```
Para obtener más información, consulte [Working with packages in CodeArtifact](https://docs.aws.amazon.com/codeartifact/latest/ug/packages.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [DisposePackageVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/dispose-package-versions.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-authorization-token`
<a name="codeartifact_GetAuthorizationToken_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-authorization-token`.

**AWS CLI**  
**Obtención de un token de autorización**  
El siguiente ejemplo de `get-authorization-token`, se recupera un token de autorización de CodeArtifact.  

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

```
This command will return the authorization token. You can store the output in an environment variable when calling the command.
```
Para obtener más información, consulte [Configure pip without the login command](https://docs.aws.amazon.com/codeartifact/latest/ug/python-configure-without-pip.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [GetAuthorizationToken](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-authorization-token.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-domain-permissions-policy`
<a name="codeartifact_GetDomainPermissionsPolicy_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-domain-permissions-policy`.

**AWS CLI**  
**Obtención del documento de la política de permisos de un dominio**  
En el siguiente ejemplo de `get-domain-permissions-policy`, se obtiene la política de permisos adjunta a un dominio denominado test-domain.  

```
aws codeartifact get-domain-permissions-policy \
    --domain test-domain
```
Salida:  

```
{
    "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"
            }
        }
    ]
}
```
Para obtener más información, consulte [Read a domain policy](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-policies.html#reading-a-domain-policy) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la APl, consulte [GetDomainPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-domain-permissions-policy.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-package-version-asset`
<a name="codeartifact_GetPackageVersionAsset_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-package-version-asset`.

**AWS CLI**  
**Obtención de un activo de una versión de paquete**  
En el siguiente ejemplo de `get-package-version-asset`, se recupera el activo `package.tgz` de la versión 4.0.0 de un paquete npm denominado 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
```
Salida:  

```
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="
}
```
Para obtener más información, consulte [List package version assets](https://docs.aws.amazon.com/codeartifact/latest/ug/list-assets.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [GetPackageVersionAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-package-version-asset.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-package-version-readme`
<a name="codeartifact_GetPackageVersionReadme_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-package-version-readme`.

**AWS CLI**  
**Obtención del archivo readme de una versión de paquete**  
En el siguiente ejemplo de `get-package-version-readme`, se obtiene el activo readme de la versión 4.0.0 de un paquete npm denominado test-package.  

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

```
{
    "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="
}
```
Para obtener más información, consulte [View package version readme file](https://docs.aws.amazon.com/codeartifact/latest/ug/describe-package-version.html#view-package-readme) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [GetPackageVersionReadme](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-package-version-readme.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-repository-endpoint`
<a name="codeartifact_GetRepositoryEndpoint_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-repository-endpoint`.

**AWS CLI**  
**Obtención del punto de conexión de la URL de un repositorio**  
En el siguiente ejemplo de `get-repository-endpoint`, se obtiene el punto de conexión npm del repositorio test-repo.  

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

```
{
    "repositoryEndpoint": "https://test-domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/npm/test-repo/"
}
```
Para obtener más información, consulte [Connect to a repository](https://docs.aws.amazon.com/codeartifact/latest/ug/connect-repo.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [GetRepositoryEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-repository-endpoint.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-repository-permissions-policy`
<a name="codeartifact_GetRepositoryPermissionsPolicy_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-repository-permissions-policy`.

**AWS CLI**  
**Obtención del documento de la política de permisos de un repositorio**  
En el siguiente ejemplo de `get-repository-permissions-policy`, se obtiene la política de permisos adjunta a un repositorio denominado test-repo.  

```
aws codeartifact get-repository-permissions-policy \
    --domain test-domain \
    --repository test-repo
```
Salida:  

```
{
    "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": "*"
        }
    ]
}
```
Para obtener más información, consulte [Read a policy](https://docs.aws.amazon.com/codeartifact/latest/ug/repo-policies.html#setting-a-policy) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [GetRepositoryPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/get-repository-permissions-policy.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-domains`
<a name="codeartifact_ListDomains_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-domains`.

**AWS CLI**  
**Para enumerar dominios**  
En el siguiente ejemplo de `list-domains`, se obtiene un resumen de todos los dominios que pertenecen a la cuenta de AWS que realiza la llamada.  

```
aws codeartifact list-domains
```
Salida:  

```
{
    "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"
        }
    ]
}
```
Para obtener más información, consulte [Working with domains in CodeArtifact](https://docs.aws.amazon.com/codeartifact/latest/ug/domains.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [ListDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-domains.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-package-version-assets`
<a name="codeartifact_ListPackageVersionAssets_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-package-version-assets`.

**AWS CLI**  
**Recuperación de los activos de una versión de paquete**  
En el siguiente ejemplo de `list-package-version-assets`, se recuperan los activos de la versión 4.0.0 de un paquete npm denominado test-package.  

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

```
{
    "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"
            }
        }
    ]
}
```
Para obtener más información, consulte [List package version assets](https://docs.aws.amazon.com/codeartifact/latest/ug/list-assets.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [ListPackageVersionAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-package-version-assets.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-package-version-dependencies`
<a name="codeartifact_ListPackageVersionDependencies_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-package-version-dependencies`.

**AWS CLI**  
**Recuperación de las dependencias de la versión de un paquete**  
En el siguiente ejemplo de `list-package-version-dependencies`, se recuperan las dependencias de la versión 4.0.0 de un paquete npm denominado test-package.  

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

```
{
    "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"
        }
    ]
}
```
Para obtener más información, consulte [View and update package version details and dependencies](https://docs.aws.amazon.com/codeartifact/latest/ug/describe-package-version.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [ListPackageVersionDependencies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-package-version-dependencies.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-package-versions`
<a name="codeartifact_ListPackageVersions_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-package-versions`.

**AWS CLI**  
**Generación de una lista de las versiones de un paquete**  
En el siguiente ejemplo de `list-package-versions`, se genera una lista de las versiones de un paquete denominado `kind-of`.  

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

```
{
    "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"
        }
    ]
}
```
Para obtener más información, consulte [List package versions](https://docs.aws.amazon.com/codeartifact/latest/ug/list-packages-versions.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [ListPackageVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-package-versions.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-packages`
<a name="codeartifact_ListPackages_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-packages`.

**AWS CLI**  
**Generación de una lista de los paquetes de un repositorio**  
En el siguiente ejemplo de `list-packages`, se genera una lista de los paquetes de un repositorio denominado `test-repo` en un dominio denominado `test-domain`.  

```
aws codeartifact list-packages \
    --domain test-domain \
    --repository test-repo
```
Salida:  

```
{
    "packages": [
        {
            "format": "npm",
            "package": "lodash"
        }
        {
            "format": "python",
            "package": "test-package"
        }
    ]
}
```
Para obtener más información, consulte [List package names](https://docs.aws.amazon.com/codeartifact/latest/ug/list-packages.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [ListPackages](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-packages.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-repositories-in-domain`
<a name="codeartifact_ListRepositoriesInDomain_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-repositories-in-domain`.

**AWS CLI**  
**Generación de una lista de los repositorios de un dominio**  
En el siguiente ejemplo de `list-repositories-in-domain`, se obtiene un resumen de todos los repositorios del dominio test-domain.  

```
aws codeartifact list-repositories-in-domain \
    --domain test-domain
```
Salida:  

```
{
    "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."
        }
    ]
}
```
Para obtener más información, consulte [List repositories](https://docs.aws.amazon.com/codeartifact/latest/ug/list-repos.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [ListRepositoriesInDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-repositories-in-domain.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-repositories`
<a name="codeartifact_ListRepositories_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-repositories`.

**AWS CLI**  
**Generación de una lista de repositorios**  
En el siguiente ejemplo de `list-repositories`, se obtiene un resumen de todos los repositorios de un dominio que pertenece a la cuenta de AWS que realiza la llamada.  

```
aws codeartifact list-repositories
```
Salida:  

```
{
    "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."
        }
    ]
}
```
Para obtener más información, consulte [List repositories](https://docs.aws.amazon.com/codeartifact/latest/ug/list-repos.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [ListRepositories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/list-repositories.html) en la *Referencia de comandos de la AWS CLI*. 

### `login`
<a name="codeartifact_Login_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `login`.

**AWS CLI**  
**Configuración de la autenticación en el repositorio con el comando login**  
En el siguiente ejemplo de `login`, se configura el administrador de paquetes npm con un repositorio denominado test-repo dentro de un dominio denominado test-domain.  

```
aws codeartifact login \
    --domain test-domain \
    --repository test-repo \
    --tool npm
```
Salida:  

```
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
```
Para obtener más información, consulte [Getting started with the AWS CLI](https://docs.aws.amazon.com/codeartifact/latest/ug/getting-started-cli.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [Login](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/login.html) en la *Referencia de comandos de la AWS CLI*. 

### `put-domain-permissions-policy`
<a name="codeartifact_PutDomainPermissionsPolicy_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `put-domain-permissions-policy`.

**AWS CLI**  
**Para asociar una política de permisos a un dominio**  
En el siguiente ejemplo de `put-domain-permissions-policy`, se asocia una política de permisos definida en el archivo policy.json a un dominio denominado test-domain.  

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

```
{
    "policy": {
        "resourceArn": "arn:aws:codeartifact:region-id:111122223333:domain/test-domain",
        "document": "{ ...policy document content...}",
        "revision": "MQlyyTQRASRU3HB58gBtSDHXG7Q3hvxxxxxxx="
    }
}
```
Para obtener más información, consulte [Set a domain policy](https://docs.aws.amazon.com/codeartifact/latest/ug/domain-policies.html#set-domain-policy) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [PutDomainPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/put-domain-permissions-policy.html) en la *Referencia de comandos de la AWS CLI*. 

### `put-repository-permissions-policy`
<a name="codeartifact_PutRepositoryPermissionsPolicy_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `put-repository-permissions-policy`.

**AWS CLI**  
**Para asociar una política de permisos a un repositorio**  
En el siguiente ejemplo de `put-repository-permissions-policy`, se asocia una política de permisos definida en el archivo policy.json a un repositorio denominado test-repo.  

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

```
{
    "policy": {
        "resourceArn": "arn:aws:codeartifact:region-id:111122223333:repository/test-domain/test-repo",
        "document": "{ ...policy document content...}",
        "revision": "MQlyyTQRASRU3HB58gBtSDHXG7Q3hvxxxxxxx="
    }
}
```
Para obtener más información, consulte [Set a policy](https://docs.aws.amazon.com/codeartifact/latest/ug/repo-policies.html#setting-a-policy) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [PutRepositoryPermissionsPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/put-repository-permissions-policy.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-package-versions-status`
<a name="codeartifact_UpdatePackageVersionsStatus_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-package-versions-status`.

**AWS CLI**  
**Actualización del estado de la versión de un paquete**  
En el siguiente ejemplo de `update-package-versions-status`, se actualiza el estado de la versión 4.0.0 del paquete test-package a 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
```
Salida:  

```
{
    "successfulVersions": {
        "4.0.0": {
            "revision": "Ciqe5/9yicvkJT13b5/LdLpCyE6fqA7poa9qp+FilPs=",
            "status": "Archived"
        }
    },
    "failedVersions": {}
}
```
Para obtener más información, consulte [Update package version status](https://docs.aws.amazon.com/codeartifact/latest/ug/describe-package-version.html#update-package-version-status) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [UpdatePackageVersionsStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/update-package-versions-status.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-repository`
<a name="codeartifact_UpdateRepository_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `update-repository`.

**AWS CLI**  
**Actualización de un repositorio**  
En el siguiente ejemplo de `update-repository`, se actualiza la descripción de un repositorio denominado test-repo en un dominio denominado test-domain a “this is an updated description”.  

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

```
{
    "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": []
    }
}
```
Para obtener más información, consulte [View or modify a repository configuration](https://docs.aws.amazon.com/codeartifact/latest/ug/config-repos.html) en la *Guía del usuario de AWS CodeArtifact*.  
+  Para obtener información sobre la API, consulte [UpdateRepository](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/codeartifact/update-repository.html) en la *Referencia de comandos de la AWS CLI*.