Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# AWS RAM ejemplos que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface with 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
### `accept-resource-share-invitation`
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 más información sobre la API, consulte [AcceptResourceShareInvitation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/accept-resource-share-invitation.html)la *Referencia de AWS CLI comandos*.
### `associate-resource-share-permission`
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 más información sobre la API, consulte [AssociateResourceSharePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/associate-resource-share-permission.html)la *Referencia de AWS CLI comandos*.
### `associate-resource-share`
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 más información sobre la API, consulte [AssociateResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/associate-resource-share.html)la *Referencia de AWS CLI comandos*.
### `create-resource-share`
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: Para crear un recurso compartido con AWS las cuentas como principales**
En el siguiente `create-resource-share` ejemplo, se crea un recurso compartido y se concede acceso a la AWS cuenta especificada (222222222222). Si los directores especificados no forman parte de la misma AWS organización, las invitaciones se envían y deben aceptarse antes de conceder el acceso.
```
aws ram create-resource-share \
--name MyNewResourceShare \
--principals 222222222222
```
**Ejemplo 3: Para crear un recurso compartido restringido a su organización AWS **
En el siguiente `create-resource-share` ejemplo, se crea un recurso compartido que está restringido a las cuentas de la AWS organización a la que pertenece su cuenta y se agrega la OU especificada como 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 más información sobre la API, consulte [CreateResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/create-resource-share.html)la *Referencia de AWS CLI comandos*.
### `delete-resource-share`
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 más información sobre la API, consulte [DeleteResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/delete-resource-share.html)la *Referencia de AWS CLI comandos*.
### `disassociate-resource-share-permission`
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 más información sobre la API, consulte [DisassociateResourceSharePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/disassociate-resource-share-permission.html)la *Referencia de AWS CLI comandos*.
### `disassociate-resource-share`
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 más información sobre la API, consulte [DisassociateResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/disassociate-resource-share.html)la *Referencia de AWS CLI comandos*.
### `enable-sharing-with-aws-organization`
En el siguiente ejemplo de código, se muestra cómo utilizar `enable-sharing-with-aws-organization`.
**AWS CLI**
**Para permitir el uso compartido de recursos entre 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 detalles sobre la API, consulte [EnableSharingWithAwsOrganization](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/enable-sharing-with-aws-organization.html)la *Referencia de AWS CLI comandos*.
### `get-permission`
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 más información sobre la API, consulte [GetPermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-permission.html)la *Referencia de AWS CLI comandos*.
### `get-resource-policies`
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 más información sobre la API, consulte [GetResourcePolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-policies.html)la *Referencia de AWS CLI comandos*.
### `get-resource-share-associations`
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 más información sobre la API, consulte [GetResourceShareAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-share-associations.html)la *Referencia de AWS CLI comandos*.
### `get-resource-share-invitations`
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 más información sobre la API, consulte [GetResourceShareInvitations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-share-invitations.html)la *Referencia de AWS CLI comandos*.
### `get-resource-shares`
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 más información sobre la API, consulte [GetResourceShares](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/get-resource-shares.html)la *Referencia de AWS CLI comandos*.
### `list-pending-invitation-resources`
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 más información sobre la API, consulte [ListPendingInvitationResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-pending-invitation-resources.html)la *Referencia de AWS CLI comandos*.
### `list-permissions`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-permissions`.
**AWS CLI**
**Para enumerar los permisos administrados por RAM disponibles**
En el siguiente `list-permissions` ejemplo, se enumeran todos los permisos gestionados 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 más información sobre la API, consulte [ListPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-permissions.html)la *Referencia de AWS CLI comandos*.
### `list-principals`
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 más información sobre la API, consulte [ListPrincipals](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-principals.html)la *Referencia de AWS CLI comandos*.
### `list-resource-share-permissions`
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 más información sobre la API, consulte [ListResourceSharePermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-resource-share-permissions.html)la *Referencia de AWS CLI comandos*.
### `list-resource-types`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-resource-types`.
**AWS CLI**
**Para ver una lista de los tipos de recursos compatibles con la AWS RAM**
En el siguiente `list-resource-types` ejemplo, se enumeran todos los tipos de recursos que actualmente admite la 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 más información sobre la API, consulte [ListResourceTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/list-resource-types.html)la *Referencia de AWS CLI comandos*.
### `list-resources`
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)la *Referencia de AWS CLI comandos*.
### `promote-resource-share-created-from-policy`
En el siguiente ejemplo de código, se muestra cómo utilizar `promote-resource-share-created-from-policy`.
**AWS CLI**
**Para promover un uso compartido de recursos basado en políticas de recursos para lograr una funcionalidad completa en la RAM AWS **
El siguiente `promote-resource-share-created-from-policy` ejemplo toma un recurso compartido que creó 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 más información sobre la API, consulte [PromoteResourceShareCreatedFromPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/promote-resource-share-created-from-policy.html)la Referencia de comandos.AWS CLI *
### `reject-resource-share-invitation`
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 más información sobre la API, consulte [RejectResourceShareInvitation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/reject-resource-share-invitation.html)la *Referencia de AWS CLI comandos*.
### `tag-resource`
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 obtener más información sobre la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/tag-resource.html)la *Referencia de AWS CLI comandos*.
### `untag-resource`
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 obtener más información sobre la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/untag-resource.html)la *Referencia de AWS CLI comandos*.
### `update-resource-share`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-resource-share`.
**AWS CLI**
**Para actualizar un recurso compartido**
El siguiente `update-resource-share` ejemplo cambia el recurso compartido especificado para permitir el uso de directores externos que no estén en una AWS organización.
```
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 más información sobre la API, consulte [UpdateResourceShare](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ram/update-resource-share.html)la *Referencia de AWS CLI comandos*.