# AWS RAM Ejemplos de usando AWS CLI
<a name="cli_ram_code_examples"></a>

En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con AWS RAM.

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>

### `accept-resource-share-invitation`
<a name="ram_AcceptResourceShareInvitation_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `accept-resource-share-invitation`.

**AWS CLI**  
**Para aceptar una invitación a recursos compartidos**  
En el siguiente ejemplo de `accept-resource-share-invitation`, se acepta la invitación a un recurso compartido especificado. Las entidades principales de la cuenta invitada pueden empezar a utilizar inmediatamente los recursos del recurso compartido.  

```
aws ram accept-resource-share-invitation \
    --resource-share-invitation-arn arn:aws:ram:us-west-2:111111111111:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE
```
Salida:  

```
{
    "resourceShareInvitation": {
        "resourceShareInvitationArn": "arn:aws:ram:us-west-2:111111111111:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE",
        "resourceShareName": "MyLicenseShare",
        "resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE",
        "senderAccountId": "111111111111",
        "receiverAccountId": "222222222222",
        "invitationTimestamp": "2021-09-22T15:07:35.620000-07:00",
        "status": "ACCEPTED"
    }
}
```
+  Para obtener información sobre la API, consulte [AcceptResourceShareInvitation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/accept-resource-share-invitation.html) en la *Referencia de comandos de la AWS CLI*. 

### `associate-resource-share-permission`
<a name="ram_AssociateResourceSharePermission_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `associate-resource-share-permission`.

**AWS CLI**  
**Para asociar un permiso administrado por RAM con un recurso compartido**  
En el siguiente ejemplo de `associate-resource-share-permission`, se reemplaza el permiso administrado existente por el tipo de recurso correspondiente con el permiso administrado especificado. El acceso a todos los recursos del tipo de recurso correspondiente se rige por el nuevo permiso.  

```
aws ram associate-resource-share-permission \
    --permission-arn arn:aws:ram::aws:permission/AWSRAMPermissionGlueDatabaseReadWrite \
    --replace \
    --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE
```
Salida:  

```
{
    "returnValue": true
}
```
+  Para obtener información sobre la API, consulte [AssociateResourceSharePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/associate-resource-share-permission.html) en la *Referencia de comandos de la AWS CLI*. 

### `associate-resource-share`
<a name="ram_AssociateResourceShare_cli_topic"></a>

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

**AWS CLI**  
**Ejemplo 1: asociación de un recurso a un recurso compartido**  
En el siguiente ejemplo de `associate-resource-share`, se añade una configuración de licencia al recurso compartido especificado.  

```
aws ram associate-resource-share \
    --resource-share arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE \
    --resource-arns arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-36be0485f5ae379cc74cf8e92EXAMPLE
```
Salida:  

```
{
    "resourceShareAssociations": [
        {
           "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE",
           "associatedEntity": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-36be0485f5ae379cc74cf8e92EXAMPLE",
           "associationType": "RESOURCE",
           "status": "ASSOCIATING",
           "external": false
        }
    ]
}
```
**Ejemplo 2: asociación de una entidad principal a un recurso compartido**  
En el siguiente ejemplo de `associate-resource-share`, se concede acceso al recurso compartido especificado a todas las cuentas de la unidad organizativa especificada.  

```
aws ram associate-resource-share \
    --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE \
    --principals arn:aws:organizations::123456789012:ou/o-63bEXAMPLE/ou-46xi-rEXAMPLE
```
Salida:  

```
{
    "resourceShareAssociations": [
        {
            "status": "ASSOCIATING",
            "associationType": "PRINCIPAL",
            "associatedEntity": "arn:aws:organizations::123456789012:ou/o-63bEXAMPLE/ou-46xi-rEXAMPLE",
            "external": false,
            "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE"
        }
    ]
}
```
+  Para obtener información sobre la API, consulte [AssociateResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/associate-resource-share.html) en la *Referencia de comandos de la AWS CLI*. 

### `create-resource-share`
<a name="ram_CreateResourceShare_cli_topic"></a>

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

**AWS CLI**  
**Ejemplo 1: creación de un recurso compartido**  
En el siguiente ejemplo de `create-resource-share`, se crea un recurso compartido vacío con un nombre específico. Debe agregar los recursos, las entidades principales y los permisos al recurso compartido por separado.  

```
aws ram create-resource-share \
    --name MyNewResourceShare
```
Salida:  

```
{
    "resourceShare": {
        "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/4476c27d-8feb-4b21-afe9-7de23EXAMPLE",
        "name": "MyNewResourceShare",
        "owningAccountId": "123456789012",
        "allowExternalPrincipals": true,
        "status": "ACTIVE",
        "creationTime": 1634586271.302,
        "lastUpdatedTime": 1634586271.302
    }
}
```
**Ejemplo 2: creación de un recurso compartido con cuentas de AWS como entidades principales**  
En el siguiente de `create-resource-share` ejemplo, se crea un recurso compartido y se concede acceso a la cuenta de AWS especificada (222222222222). Si las entidades principales especificadas no forman parte de la misma organización de AWS, las invitaciones se envían y deben aceptarse antes de conceder el acceso.  

```
aws ram create-resource-share \
    --name MyNewResourceShare \
    --principals 222222222222
```
**Ejemplo 3: creación de un recurso compartido restringido a su organización AWS**  
El siguiente ejemplo de `create-resource-share` crea un recurso compartido que está restringido a las cuentas de la organización AWS a la que pertenezca su cuenta y agrega la unidad organizativa especificada como entidad principal. Todas las cuentas de esa unidad organizativa pueden usar los recursos del recurso compartido.  

```
aws ram create-resource-share \
    --name MyNewResourceShare \
    --no-allow-external-principals \
    --principals arn:aws:organizations::123456789012:ou/o-63bEXAMPLE/ou-46xi-rEXAMPLE
```
Salida:  

```
{
    "resourceShare": {
        "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7be8694e-095c-41ca-9ce8-7be4aEXAMPLE",
        "name": "MyNewResourceShare",
        "owningAccountId": "123456789012",
        "allowExternalPrincipals": false,
        "status": "ACTIVE",
        "creationTime": 1634587042.49,
        "lastUpdatedTime": 1634587042.49
    }
}
```
+  Para obtener información sobre la API, consulte [CreateResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/create-resource-share.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-resource-share`
<a name="ram_DeleteResourceShare_cli_topic"></a>

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

**AWS CLI**  
**Para eliminar un recurso compartido**  
En el siguiente ejemplo de `delete-resource-share`, se elimina el recurso compartido especificado.  

```
aws ram delete-resource-share \
    --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
```
El siguiente resultado indica que se ha realizado correctamente:  

```
{
    "returnValue": true
}
```
+  Para obtener información sobre la API, consulte [DeleteResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/delete-resource-share.html) en la *Referencia de comandos de la AWS CLI*. 

### `disassociate-resource-share-permission`
<a name="ram_DisassociateResourceSharePermission_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `disassociate-resource-share-permission`.

**AWS CLI**  
**Para eliminar un permiso administrado por RAM para un tipo de recurso desde un recurso compartido**  
En el siguiente ejemplo de `disassociate-resource-share-permission`, se elimina el permiso administrado por RAM para las bases de datos Glue del recurso compartido especificado.  

```
aws ram disassociate-resource-share-permission \
    --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE \
    --permission-arn arn:aws:ram::aws:permission/AWSRAMPermissionGlueDatabaseReadWrite
```
Salida:  

```
{
    "returnValue": true
}
```
+  Para obtener información sobre la API, consulte [DisassociateResourceSharePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/disassociate-resource-share-permission.html) en la *Referencia de comandos de AWS CLI*. 

### `disassociate-resource-share`
<a name="ram_DisassociateResourceShare_cli_topic"></a>

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

**AWS CLI**  
**Eliminar un recurso de un recurso compartido**  
En el siguiente ejemplo de `disassociate-resource-share`, se elimina el recurso especificado, en este caso una subred de VPC, del recurso compartido especificado. Las entidades principales con acceso al recurso compartido ya no pueden realizar operaciones en ese recurso.  

```
aws ram disassociate-resource-share \
    --resource-arns arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1fEXAMPLE \
    --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
```
Salida:  

```
{
    "resourceShareAssociations": [
        "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
        "associatedEntity": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1fEXAMPLE",
        "associationType": "RESOURCE",
        "status": "DISASSOCIATING",
        "external": false
    ]
}
```
+  Para obtener información sobre la API, consulte [DisassociateResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/disassociate-resource-share.html) en la *Referencia de la comandos de la AWS CLI*. 

### `enable-sharing-with-aws-organization`
<a name="ram_EnableSharingWithAwsOrganization_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `enable-sharing-with-aws-organization`.

**AWS CLI**  
**Habilitar recursos compartidos en AWS Organizations**  
El siguiente ejemplo de `enable-sharing-with-aws-organization` permite compartir recursos entre la organización y las unidades organizativas.  

```
aws ram enable-sharing-with-aws-organization
```
El siguiente resultado indica que se ha realizado correctamente.  

```
{
    "returnValue": true
}
```
+  Para obtener información sobre la API, consulte [EnableSharingWithAwsOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/enable-sharing-with-aws-organization.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-permission`
<a name="ram_GetPermission_cli_topic"></a>

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

**AWS CLI**  
**Para recuperar los detalles de un permiso administrado por RAM**  
En el siguiente ejemplo de `get-permission` se muestran los detalles de la versión predeterminada del permiso administrado por RAM especificado.  

```
aws ram get-permission \
    --permission-arn arn:aws:ram::aws:permission/AWSRAMPermissionGlueTableReadWriteForDatabase
```
Salida:  

```
{
    "permission": {
        "arn": "arn:aws:ram::aws:permission/AWSRAMPermissionGlueTableReadWriteForDatabase",
        "version": "2",
        "defaultVersion": true,
        "name": "AWSRAMPermissionGlueTableReadWriteForDatabase",
        "resourceType": "glue:Database",
        "permission": "{\"Effect\":\"Allow\",\"Action\":[\"glue:GetTable\", \"glue:UpdateTable\", \"glue:DeleteTable\", \"glue:BatchDeleteTable\", \"glue:BatchDeleteTableVersion\", \"glue:GetTableVersion\", \"glue:GetTableVersions\", \"glue:GetPartition\", \"glue:GetPartitions\", \"glue:BatchGetPartition\", \"glue:BatchCreatePartition\", \"glue:CreatePartition\", \"glue:UpdatePartition\", \"glue:BatchDeletePartition\", \"glue:DeletePartition\", \"glue:GetTables\", \"glue:SearchTables\"]}",
        "creationTime": 1624912434.431,
        "lastUpdatedTime": 1624912434.431,
        "isResourceTypeDefault": false
    }
}
```
+  Para obtener información sobre la API, consulte [GetPermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-permission.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-resource-policies`
<a name="ram_GetResourcePolicies_cli_topic"></a>

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

**AWS CLI**  
**Para obtener las políticas de un recurso**  
En el siguiente ejemplo de `get-resource-policies`, se muestran las políticas de permisos basadas en recursos para el recurso especificado asociado a un recurso compartido.  

```
aws ram get-resource-policies \
    --resource-arns arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1fEXAMPLE
```
Salida:  

```
{
    "policies": [
         "{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"RamStatement1\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":[]},\"Action\":[\"ec2:RunInstances\",\"ec2:CreateNetworkInterface\",\"ec2:DescribeSubnets\"],\"Resource\":\"arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1fEXAMPLE\"}]}"
    ]
}
```
+  Para obtener información sobre la API, consulte [GetResourcePolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-policies.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-resource-share-associations`
<a name="ram_GetResourceShareAssociations_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-resource-share-associations`.

**AWS CLI**  
**Ejemplo 1: enumeración de todas las asociaciones de recursos de todos los tipos de recursos**  
El siguiente ejemplo de `get-resource-share-associations` muestra las asociaciones de recursos para todos los tipos de recursos en todos sus recursos compartidos.  

```
aws ram get-resource-share-associations \
    --association-type RESOURCE
```
Salida:  

```
{
    "resourceShareAssociations": [
        {
            "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
            "associatedEntity": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1fEXAMPLE",
            "resourceShareName": "MySubnetShare",
            "associationType": "RESOURCE",
            "status": "ASSOCIATED",
            "creationTime": 1565303590.973,
            "lastUpdatedTime": 1565303591.695,
            "external": false
        },
        {
            "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/8167bdfe-4480-4a01-8632-315e0EXAMPLE",
            "associatedEntity": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-36be0485f5ae379cc74cf8e92EXAMPLE",
            "resourceShareName": "MyLicenseShare",
            "associationType": "RESOURCE",
            "status": "ASSOCIATED",
            "creationTime": 1632342958.457,
            "lastUpdatedTime": 1632342958.907,
            "external": false
        }
    ]
}
```
**Ejemplo 2: enumeración de las asociaciones de las entidades principales de un recurso compartido**  
En el siguiente ejemplo de `get-resource-share-associations`, se enumeran solo las asociaciones de las entidades principales únicamente para el recurso compartido especificado.  

```
aws ram get-resource-share-associations \
   --resource-share-arns arn:aws:ram:us-west-2:123456789012:resource-share/7be8694e-095c-41ca-9ce8-7be4aEXAMPLE \
   --association-type PRINCIPAL
```
Salida:  

```
{
    "resourceShareAssociations": [
        {
            "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7be8694e-095c-41ca-9ce8-7be4aEXAMPLE",
            "resourceShareName": "MyNewResourceShare",
            "associatedEntity": "arn:aws:organizations::123456789012:ou/o-63bEXAMPLE/ou-46xi-rEXAMPLE",
            "associationType": "PRINCIPAL",
            "status": "ASSOCIATED",
            "creationTime": 1634587042.49,
            "lastUpdatedTime": 1634587044.291,
            "external": false
        }
    ]
}
```
+  Para obtener información sobre la API, consulte [GetResourceShareAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-share-associations.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-resource-share-invitations`
<a name="ram_GetResourceShareInvitations_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `get-resource-share-invitations`.

**AWS CLI**  
**Para enumerar sus invitaciones a compartir recursos**  
En el siguiente ejemplo de `get-resource-share-invitations`, se muestran las invitaciones actuales para compartir recursos.  

```
aws ram get-resource-share-invitations
```
Salida:  

```
{
    "resourceShareInvitations": [
        {
            "resourceShareInvitationArn": "arn:aws:ram:us-west2-1:111111111111:resource-share-invitation/32b639f0-14b8-7e8f-55ea-e6117EXAMPLE",
            "resourceShareName": "project-resource-share",
            "resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/fcb639f0-1449-4744-35bc-a983fEXAMPLE",
            "senderAccountId": "111111111111",
            "receiverAccountId": "222222222222",
            "invitationTimestamp": 1565312166.258,
            "status": "PENDING"
        }
    ]
}
```
+  Para obtener información sobre la API, consulte [GetResourceShareInvitations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-share-invitations.html) en la *Referencia de comandos de la AWS CLI*. 

### `get-resource-shares`
<a name="ram_GetResourceShares_cli_topic"></a>

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

**AWS CLI**  
**Ejemplo 1: enumeración de los recursos compartidos que le pertenecen y compartirlos con otros**  
En el siguiente ejemplo de `get-resource-shares`, se enumeran los recursos compartidos que se crearon y que se comparten con otros.  

```
aws ram get-resource-shares \
    --resource-owner SELF
```
Salida:  

```
{
    "resourceShares": [
        {
            "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/3ab63985-99d9-1cd2-7d24-75e93EXAMPLE",
            "name": "my-resource-share",
            "owningAccountId": "123456789012",
            "allowExternalPrincipals": false,
            "status": "ACTIVE",
            "tags": [
                {
                    "key": "project",
                    "value": "lima"
                }
            ]
            "creationTime": 1565295733.282,
            "lastUpdatedTime": 1565295733.282
        },
        {
            "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
            "name": "my-resource-share",
            "owningAccountId": "123456789012",
            "allowExternalPrincipals": true,
            "status": "ACTIVE",
            "creationTime": 1565295733.282,
            "lastUpdatedTime": 1565295733.282
        }
    ]
}
```
**Ejemplo 2: enumeración de los recursos compartidos propiedad de otros y compartidos con usted**  
En el siguiente ejemplo de `get-resource-shares`, se enumeran los recursos compartidos que han creado otros y que han compartido con usted. En este ejemplo, no hay ninguno.  

```
aws ram get-resource-shares \
    --resource-owner OTHER-ACCOUNTS
```
Salida:  

```
{
    "resourceShares": []
}
```
+  Para obtener información sobre la API, consulte [GetResourceShares](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-shares.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-pending-invitation-resources`
<a name="ram_ListPendingInvitationResources_cli_topic"></a>

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

**AWS CLI**  
**Para enumerar los recursos que están disponibles en un recurso compartido pendiente**  
En el siguiente ejemplo de `list-pending-invitation-resources`, se enumeran todos los recursos que se encuentran en el recurso compartido asociado a la invitación especificada.  

```
aws ram list-pending-invitation-resources \
    --resource-share-invitation-arn arn:aws:ram:us-west-2:123456789012:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE
```
Salida:  

```
{
   "resources": [
        {
            "arn": "arn:aws:ec2:us-west-2:123456789012:subnet/subnet-04a555b0e6EXAMPLE",
            "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7be8694e-095c-41ca-9ce8-7be4aEXAMPLE",
            "creationTime": 1634676051.269,
            "lastUpdatedTime": 1634676052.07,
            "status": "AVAILABLE",
            "type": "ec2:Subnet"
        },
        {
            "arn": "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-36be0485f5ae379cc74cf8e92EXAMPLE",
            "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
            "creationTime": 1624912434.431,
            "lastUpdatedTime": 1624912434.431,
            "status": "AVAILABLE",
            "type": "license-manager:LicenseConfiguration"
      }
   ]
}
```
+  Para obtener información sobre la API, consulte [ListPendingInvitationResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-pending-invitation-resources.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-permissions`
<a name="ram_ListPermissions_cli_topic"></a>

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

**AWS CLI**  
**Para enumerar los permisos administrados por RAM disponibles**  
El siguiente ejemplo de `list-permissions` enumera todos los permisos administrados por RAM disponibles únicamente para el tipo de recurso de la base de datos AWS Glue.  

```
aws ram list-permissions \
    --resource-type glue:Database
```
Salida:  

```
{
    "permissions": [
        {
            "arn": "arn:aws:ram::aws:permission/AWSRAMDefaultPermissionGlueDatabase",
            "version": "1",
            "defaultVersion": true,
            "name": "AWSRAMDefaultPermissionGlueDatabase",
            "resourceType": "glue:Database",
            "creationTime": 1592007820.935,
            "lastUpdatedTime": 1592007820.935,
            "isResourceTypeDefault": true
        },
        {
            "arn": "arn:aws:ram::aws:permission/AWSRAMPermissionGlueAllTablesReadWriteForDatabase",
            "version": "2",
            "defaultVersion": true,
            "name": "AWSRAMPermissionGlueAllTablesReadWriteForDatabase",
            "resourceType": "glue:Database",
            "creationTime": 1624912413.323,
            "lastUpdatedTime": 1624912413.323,
            "isResourceTypeDefault": false
        },
        {
            "arn": "arn:aws:ram::aws:permission/AWSRAMPermissionGlueDatabaseReadWrite",
            "version": "2",
            "defaultVersion": true,
            "name": "AWSRAMPermissionGlueDatabaseReadWrite",
            "resourceType": "glue:Database",
            "creationTime": 1624912417.4,
            "lastUpdatedTime": 1624912417.4,
            "isResourceTypeDefault": false
        },
        {
            "arn": "arn:aws:ram::aws:permission/AWSRAMPermissionGlueTableReadWriteForDatabase",
            "version": "2",
            "defaultVersion": true,
            "name": "AWSRAMPermissionGlueTableReadWriteForDatabase",
            "resourceType": "glue:Database",
            "creationTime": 1624912434.431,
            "lastUpdatedTime": 1624912434.431,
            "isResourceTypeDefault": false
        }
    ]
}
```
El siguiente ejemplo de `list-permissions` muestra los permisos administrados por RAM disponibles para todos los tipos de recursos.  

```
aws ram list-permissions
```
Salida:  

```
{
    "permissions": [
        {
            "arn": "arn:aws:ram::aws:permission/AWSRAMBlankEndEntityCertificateAPICSRPassthroughIssuanceCertificateAuthority",
            "version": "1",
            "defaultVersion": true,
            "name": "AWSRAMBlankEndEntityCertificateAPICSRPassthroughIssuanceCertificateAuthority",
            "resourceType": "acm-pca:CertificateAuthority",
            "creationTime": 1623264861.085,
            "lastUpdatedTime": 1623264861.085,
            "isResourceTypeDefault": false
        },
        {
            "arn": "arn:aws:ram::aws:permission/AWSRAMDefaultPermissionAppMesh",
            "version": "1",
            "defaultVersion": true,
            "name": "AWSRAMDefaultPermissionAppMesh",
            "resourceType": "appmesh:Mesh",
            "creationTime": 1589307188.584,
            "lastUpdatedTime": 1589307188.584,
            "isResourceTypeDefault": true
        },
        ...TRUNCATED FOR BREVITY...
        {
            "arn": "arn:aws:ram::aws:permission/AWSRAMSubordinateCACertificatePathLen0IssuanceCertificateAuthority",
            "version": "1",
            "defaultVersion": true,
            "name": "AWSRAMSubordinateCACertificatePathLen0IssuanceCertificateAuthority",
            "resourceType": "acm-pca:CertificateAuthority",
            "creationTime": 1623264876.75,
            "lastUpdatedTime": 1623264876.75,
            "isResourceTypeDefault": false
        }
    ]
}
```
+  Para obtener información sobre la API, consulte [ListPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-permissions.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-principals`
<a name="ram_ListPrincipals_cli_topic"></a>

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

**AWS CLI**  
**Para enumerar las entidades principales con acceso a un recurso**  
En el siguiente ejemplo de `list-principals`, se muestra una lista de las entidades principales que pueden acceder a los recursos del tipo especificado a través de cualquier recurso compartido.  

```
aws ram list-principals \
    --resource-type ec2:Subnet
```
Salida:  

```
{
    "principals": [
        {
            "id": "arn:aws:organizations::123456789012:ou/o-gx7EXAMPLE/ou-29c5-zEXAMPLE",
            "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
            "creationTime": 1565298209.737,
            "lastUpdatedTime": 1565298211.019,
            "external": false
        }
    ]
}
```
+  Para obtener información sobre la API, consulte [ListPrincipals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-principals.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-resource-share-permissions`
<a name="ram_ListResourceSharePermissions_cli_topic"></a>

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

**AWS CLI**  
**Para enumerar todos los permisos de RAM administrados actualmente asociados a un recurso compartido**  
En el siguiente ejemplo de `list-resource-share-permissions` se enumeran todos los permisos administrados por RAM asociados al recurso compartido especificado.  

```
aws ram list-resource-share-permissions \
    --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/27d09b4b-5e12-41d1-a4f2-19dedEXAMPLE
```
Salida:  

```
{
    "permissions": [
        {
            "arn": "arn:aws:ram::aws:permission/AWSRAMDefaultPermissionLicenseConfiguration",
            "version": "1",
            "resourceType": "license-manager:LicenseConfiguration",
            "status": "ASSOCIATED",
            "lastUpdatedTime": 1632342984.234
        },
        {
            "arn": "arn:aws:ram::aws:permission/AWSRAMPermissionGlueDatabaseReadWrite",
            "version": "2",
            "resourceType": "glue:Database",
            "status": "ASSOCIATED",
            "lastUpdatedTime": 1632512462.297
        }
    ]
}
```
+  Para obtener información sobre la API, consulte [ListResourceSharePermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-resource-share-permissions.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-resource-types`
<a name="ram_ListResourceTypes_cli_topic"></a>

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

**AWS CLI**  
**Para enumerar los tipos de recursos que admite AWS RAM**  
En el siguiente ejemplo de `list-resource-types`, se enumeran todos los tipos de recursos que actualmente admite AWS RAM.  

```
aws ram list-resource-types
```
Salida:  

```
{
    "resourceTypes": [
        {
            "resourceType": "route53resolver:FirewallRuleGroup",
            "serviceName": "route53resolver"
        },
        {
            "resourceType": "ec2:LocalGatewayRouteTable",
            "serviceName": "ec2"
        },
        ...OUTPUT TRUNCATED FOR BREVITY...
        {
            "resourceType": "ec2:Subnet",
            "serviceName": "ec2"
        },
        {
            "resourceType": "ec2:TransitGatewayMulticastDomain",
            "serviceName": "ec2"
        }
    ]
}
```
+  Para obtener información sobre la API, consulte [ListResourceTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-resource-types.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-resources`
<a name="ram_ListResources_cli_topic"></a>

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

**AWS CLI**  
**Para enumerar los recursos asociados a un recurso compartido**  
En el siguiente ejemplo de `list-resources`, se enumeran todos los recursos del recurso compartido especificado que son del tipo de recurso especificado.  

```
aws ram list-resources \
    --resource-type ec2:Subnet \
    --resource-owner SELF \
    --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
```
Salida:  

```
{
    "resources": [
        {
            "arn": "aarn:aws:ec2:us-west-2:123456789012:subnet/subnet-0250c25a1f4e15235",
            "type": "ec2:Subnet",
            "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
            "creationTime": 1565301545.023,
            "lastUpdatedTime": 1565301545.947
        }
    ]
}
```
+  Para obtener más información sobre la API, consulte [ListResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-resources.html) en la *Referencia de comandos de la AWS CLI*. 

### `promote-resource-share-created-from-policy`
<a name="ram_PromoteResourceShareCreatedFromPolicy_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `promote-resource-share-created-from-policy`.

**AWS CLI**  
**Para promover un recurso compartido basado en políticas de recursos con el objetivo de lograr una funcionalidad completa en AWS RAM**  
El siguiente ejemplo de `promote-resource-share-created-from-policy` toma un recurso compartido que usted ha creado implícitamente al adjuntar una política basada en recursos y lo convierte para que sea completamente funcional con la consola AWS RAM y sus operaciones de CLI y API.  

```
aws ram promote-resource-share-created-from-policy \
    --resource-share-arn arn:aws:ram:us-east-1:123456789012:resource-share/91fa8429-2d06-4032-909a-90909EXAMPLE
```
Salida:  

```
{
    "returnValue": true
}
```
+  Para obtener información sobre la API, consulte [PromoteResourceShareCreatedFromPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/promote-resource-share-created-from-policy.html) en la *Referencia de comandos de la AWS CLI*. 

### `reject-resource-share-invitation`
<a name="ram_RejectResourceShareInvitation_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `reject-resource-share-invitation`.

**AWS CLI**  
**Para rechazar una invitación de un recurso compartido**  
En el siguiente ejemplo de `reject-resource-share-invitation`, se rechaza la invitación de un recurso compartido especificado.  

```
aws ram reject-resource-share-invitation \
    --resource-share-invitation-arn arn:aws:ram:us-west-2:111111111111:resource-share-invitation/32b639f0-14b8-7e8f-55ea-e6117EXAMPLE
```
Salida:  

```
"resourceShareInvitations": [
    {
        "resourceShareInvitationArn": "arn:aws:ram:us-west2-1:111111111111:resource-share-invitation/32b639f0-14b8-7e8f-55ea-e6117EXAMPLE",
        "resourceShareName": "project-resource-share",
        "resourceShareArn": "arn:aws:ram:us-west-2:111111111111:resource-share/fcb639f0-1449-4744-35bc-a983fEXAMPLE",
        "senderAccountId": "111111111111",
        "receiverAccountId": "222222222222",
        "invitationTimestamp": 1565319592.463,
        "status": "REJECTED"
    }
]
```
+  Para obtener información sobre la API, consulte [RejectResourceShareInvitation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/reject-resource-share-invitation.html) en la *Referencia de comandos de la AWS CLI*. 

### `tag-resource`
<a name="ram_TagResource_cli_topic"></a>

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

**AWS CLI**  
**Para agregar etiquetas a un recurso compartido**  
En el siguiente ejemplo de `tag-resource`, se agrega una clave de etiqueta de `project` y un valor `lima` asociado al recurso compartido especificado.  

```
aws ram tag-resource \
    --tags key=project,value=lima \
    --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
```
Este comando no genera ninguna salida.  
+  Para ver los detalles de la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/tag-resource.html) en la *Referencia de comandos de la AWS CLI*. 

### `untag-resource`
<a name="ram_UntagResource_cli_topic"></a>

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

**AWS CLI**  
**Para eliminar etiquetas de un recurso compartido**  
En el siguiente ejemplo de `untag-resource`, se elimina la clave de etiqueta `project` y su valor asociado desde el recurso compartido especificado.  

```
aws ram untag-resource \
    --tag-keys project \
    --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
```
Este comando no genera ninguna salida.  
+  Para ver los detalles de la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/untag-resource.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-resource-share`
<a name="ram_UpdateResourceShare_cli_topic"></a>

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

**AWS CLI**  
**Para actualizar un recurso compartido**  
En el siguiente ejemplo de `update-resource-share`, se cambia el recurso compartido especificado para permitir el acceso a las entidades principales externas que no estén en una organización AWS.  

```
aws ram update-resource-share \
    --allow-external-principals \
    --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE
```
Salida:  

```
{
    "resourceShare": {
        "resourceShareArn": "arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE",
        "name": "my-resource-share",
        "owningAccountId": "123456789012",
        "allowExternalPrincipals": true,
        "status": "ACTIVE",
        "creationTime": 1565295733.282,
        "lastUpdatedTime": 1565303080.023
    }
}
```
+  Para obtener información sobre la API, consulte [UpdateResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/update-resource-share.html) en la *Referencia de comandos de la AWS CLI*.