AWS RAM contoh menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface with AWS RAM.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Topik

Tindakan

Tindakan

Contoh kode berikut menunjukkan cara menggunakanaccept-resource-share-invitation.

AWS CLI

Untuk menerima undangan berbagi sumber daya

accept-resource-share-invitationContoh berikut menerima undangan berbagi sumber daya yang ditentukan. Kepala sekolah di akun yang diundang dapat segera mulai menggunakan sumber daya dalam saham.


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

Output:


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

Untuk detail API, lihat AcceptResourceShareInvitation di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanassociate-resource-share-permission.

AWS CLI

Untuk mengaitkan izin terkelola RAM dengan berbagi sumber daya

associate-resource-share-permissionContoh berikut menggantikan izin terkelola yang ada untuk jenis sumber daya yang relevan dengan izin terkelola yang ditentukan. Akses ke semua sumber daya dari jenis sumber daya yang relevan diatur oleh izin baru.


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

Output:


{
    "returnValue": true
}

Untuk detail API, lihat AssociateResourceSharePermission di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanassociate-resource-share.

AWS CLI

Contoh 1: Untuk mengaitkan sumber daya dengan pembagian sumber daya

associate-resource-shareContoh berikut menambahkan konfigurasi lisensi ke berbagi sumber daya yang ditentukan.


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

Output:


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

Contoh 2: Untuk mengaitkan prinsipal dengan pembagian sumber daya

associate-resource-shareContoh berikut memberikan akses untuk berbagi sumber daya yang ditentukan ke semua akun di unit organisasi yang ditentukan.


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

Output:


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

Untuk detail API, lihat AssociateResourceShare di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-resource-share.

AWS CLI

Contoh 1: Untuk membuat berbagi sumber daya

create-resource-shareContoh berikut membuat berbagi sumber daya kosong dengan nama yang ditentukan. Anda harus menambahkan sumber daya, prinsipal, dan izin secara terpisah ke berbagi.


aws ram create-resource-share \
    --name MyNewResourceShare

Output:


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

Contoh 2: Untuk membuat berbagi sumber daya dengan AWS akun sebagai prinsipal

create-resource-shareContoh berikut membuat pembagian sumber daya dan memberikan akses ke AWS akun yang ditentukan (222222222222). Jika prinsipal yang ditentukan bukan bagian dari AWS Organisasi yang sama, maka undangan dikirim dan harus diterima sebelum akses diberikan.


aws ram create-resource-share \
    --name MyNewResourceShare \
    --principals 222222222222

Contoh 3: Untuk membuat pembagian sumber daya yang dibatasi untuk AWS Organisasi Anda

create-resource-shareContoh berikut membuat pembagian sumber daya yang dibatasi untuk akun di AWS Organisasi tempat akun Anda menjadi anggota, dan menambahkan OU yang ditentukan sebagai prinsipal. Semua akun di OU tersebut dapat menggunakan sumber daya dalam pembagian sumber daya.


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

Output:


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

Untuk detail API, lihat CreateResourceShare di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-resource-share.

AWS CLI

Untuk menghapus berbagi sumber daya

delete-resource-shareContoh berikut menghapus berbagi sumber daya yang ditentukan.


aws ram delete-resource-share \
    --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE

Output berikut menunjukkan keberhasilan:


{
    "returnValue": true
}

Untuk detail API, lihat DeleteResourceShare di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandisassociate-resource-share-permission.

AWS CLI

Untuk menghapus izin terkelola RAM untuk jenis sumber daya dari pembagian sumber daya

disassociate-resource-share-permissionContoh berikut menghapus izin yang dikelola RAM untuk database Glue dari berbagi sumber daya yang ditentukan.


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

Output:


{
    "returnValue": true
}

Untuk detail API, lihat DisassociateResourceSharePermission di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandisassociate-resource-share.

AWS CLI

Untuk menghapus sumber daya dari berbagi sumber daya

disassociate-resource-shareContoh berikut menghapus sumber daya yang ditentukan, dalam hal ini subnet VPC, dari berbagi sumber daya yang ditentukan. Setiap prinsipal dengan akses ke berbagi sumber daya tidak dapat lagi melakukan operasi pada sumber daya tersebut.


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

Output:


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

Untuk detail API, lihat DisassociateResourceShare di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanenable-sharing-with-aws-organization.

AWS CLI

Untuk mengaktifkan berbagi sumber daya di seluruh AWS Organisasi

enable-sharing-with-aws-organizationContoh berikut memungkinkan berbagi sumber daya di seluruh organisasi dan unit organisasi Anda.


aws ram enable-sharing-with-aws-organization

Output berikut menunjukkan keberhasilan.


{
    "returnValue": true
}

Untuk detail API, lihat EnableSharingWithAwsOrganization di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-permission.

AWS CLI

Untuk mengambil detail untuk izin yang dikelola RAM

get-permissionContoh berikut menampilkan detail untuk versi default dari izin terkelola RAM yang ditentukan.


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

Output:


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

Untuk detail API, lihat GetPermission di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-resource-policies.

AWS CLI

Untuk mendapatkan kebijakan untuk sumber daya

get-resource-policiesContoh berikut menampilkan kebijakan izin berbasis sumber daya untuk sumber daya tertentu yang terkait dengan pembagian sumber daya.


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

Output:


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

Untuk detail API, lihat GetResourcePolicies di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-resource-share-associations.

AWS CLI

Contoh 1: Untuk membuat daftar semua asosiasi sumber daya untuk semua jenis sumber daya

get-resource-share-associationsContoh berikut mencantumkan asosiasi sumber daya untuk semua jenis sumber daya di semua pembagian sumber daya Anda.


aws ram get-resource-share-associations \
    --association-type RESOURCE

Output:


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

Contoh 2: Untuk membuat daftar asosiasi utama untuk pembagian sumber daya

get-resource-share-associationsContoh berikut hanya mencantumkan asosiasi utama untuk hanya berbagi sumber daya yang ditentukan.


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

Output:


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

Untuk detail API, lihat GetResourceShareAssociations di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-resource-share-invitations.

AWS CLI

Untuk membuat daftar undangan berbagi sumber daya

get-resource-share-invitationsContoh berikut mencantumkan undangan berbagi sumber daya Anda saat ini.


aws ram get-resource-share-invitations

Output:


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

Untuk detail API, lihat GetResourceShareInvitations di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-resource-shares.

AWS CLI

Contoh 1: Untuk membuat daftar pembagian sumber daya yang Anda miliki dan bagikan dengan orang lain

get-resource-sharesContoh berikut mencantumkan pembagian sumber daya yang dibuat dan dibagikan dengan orang lain.


aws ram get-resource-shares \
    --resource-owner SELF

Output:


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

Contoh 2: Untuk membuat daftar pembagian sumber daya yang dimiliki oleh orang lain dan dibagikan dengan Anda

get-resource-sharesContoh berikut mencantumkan pembagian sumber daya yang dibuat dan dibagikan orang lain dengan Anda. Dalam contoh ini, tidak ada.


aws ram get-resource-shares \
    --resource-owner OTHER-ACCOUNTS

Output:


{
    "resourceShares": []
}

Untuk detail API, lihat GetResourceShares di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-pending-invitation-resources.

AWS CLI

Untuk membuat daftar sumber daya yang tersedia dalam pembagian sumber daya yang tertunda

list-pending-invitation-resourcesContoh berikut mencantumkan semua sumber daya yang ada dalam pembagian sumber daya yang terkait dengan undangan yang ditentukan.


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

Output:


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

Untuk detail API, lihat ListPendingInvitationResources di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-permissions.

AWS CLI

Untuk membuat daftar izin terkelola RAM yang tersedia

list-permissionsContoh berikut mencantumkan semua izin yang dikelola RAM yang tersedia hanya untuk jenis sumber daya database AWS Glue.


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

Output:


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

list-permissionsContoh berikut menampilkan izin terkelola RAM yang tersedia untuk semua jenis sumber daya.


aws ram list-permissions

Output:


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

Untuk detail API, lihat ListPermissions di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-principals.

AWS CLI

Untuk membuat daftar prinsipal dengan akses ke sumber daya

list-principalsContoh berikut menampilkan daftar prinsipal yang dapat mengakses sumber daya dari jenis yang ditentukan melalui berbagi sumber daya apa pun.


aws ram list-principals \
    --resource-owner SELF \
    --resource-type ec2:Subnet

Output:


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

Untuk detail API, lihat ListPrincipals di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-resource-share-permissions.

AWS CLI

Untuk membuat daftar semua izin yang dikelola RAM yang saat ini dilampirkan ke berbagi sumber daya

list-resource-share-permissionsContoh berikut mencantumkan semua izin yang dikelola RAM yang dilampirkan ke berbagi sumber daya yang ditentukan.


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

Output:


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

Untuk detail API, lihat ListResourceSharePermissions di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-resource-types.

AWS CLI

Untuk membuat daftar jenis sumber daya yang didukung oleh AWS RAM

list-resource-typesContoh berikut mencantumkan semua jenis sumber daya yang saat ini didukung oleh AWS RAM.


aws ram list-resource-types

Output:


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

Untuk detail API, lihat ListResourceTypes di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-resources.

AWS CLI

Untuk membuat daftar sumber daya yang terkait dengan pembagian sumber daya

list-resourcesContoh berikut mencantumkan semua sumber daya dalam pembagian sumber daya yang ditentukan yang berasal dari jenis sumber daya yang ditentukan.


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

Output:


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

Untuk detail API, lihat ListResources di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanpromote-resource-share-created-from-policy.

AWS CLI

Untuk mempromosikan pembagian sumber daya berbasis kebijakan sumber daya ke fungsionalitas penuh di RAM AWS

promote-resource-share-created-from-policyContoh berikut mengambil pembagian sumber daya yang Anda buat secara implisit dengan melampirkan kebijakan berbasis sumber daya, dan mengubahnya menjadi berfungsi penuh dengan konsol AWS RAM dan operasi CLI dan API-nya.


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

Output:


{
    "returnValue": true
}

Untuk detail API, lihat PromoteResourceShareCreatedFromPolicy di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanreject-resource-share-invitation.

AWS CLI

Menolak undangan berbagi sumber daya

reject-resource-share-invitationContoh berikut menolak undangan berbagi sumber daya yang ditentukan.


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

Output:


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

Untuk detail API, lihat RejectResourceShareInvitation di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menambahkan tag ke berbagi sumber daya

tag-resourceContoh berikut menambahkan kunci tag project dan nilai terkait lima ke berbagi sumber daya yang ditentukan.


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

Perintah ini tidak menghasilkan output.

Untuk detail API, lihat TagResource di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari berbagi sumber daya

untag-resourceContoh berikut menghapus kunci project tag dan nilai terkait dari berbagi sumber daya yang ditentukan.


aws ram untag-resource \
    --tag-keys project \
    --resource-share-arn arn:aws:ram:us-west-2:123456789012:resource-share/7ab63972-b505-7e2a-420d-6f5d3EXAMPLE

Perintah ini tidak menghasilkan output.

Untuk detail API, lihat UntagResource di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-resource-share.

AWS CLI

Untuk memperbarui pembagian sumber daya

update-resource-shareContoh berikut mengubah pembagian sumber daya yang ditentukan untuk mengizinkan prinsipal eksternal yang tidak ada dalam AWS Organisasi.


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

Output:


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

Untuk detail API, lihat UpdateResourceShare di Refer AWS CLI ensi Perintah.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Amazon Rekognition

Penjelajah Sumber Daya