リソースおよびリソース・グループの処理 (ibmcloud resource)
リソース・グループは、アカウント・リソースをカスタマイズ可能なグループに編成するための方法です。 IBM Cloud® コマンド・ライン・インターフェースから以下のコマンドを使用して、リソース・グループの IBM Cloud リソースを管理します。
ibmcloud resource groups
リソース・グループをリストします。
ibmcloud resource groups [--default]
コマンド・オプション
- --default (デフォルト)
- 現行アカウントのデフォルト・グループを取得します。
例
現在のターゲット・アカウントのすべてのリソース・グループをリストします
ibmcloud resource groups
現在のターゲット・アカウントのデフォルト・グループをリストします
ibmcloud resource groups --default
ibmcloud resource group
リソース・グループの詳細を表示します
ibmcloud resource group NAME [--id]
コマンド・オプション
- NAME (必須)
- リソース・グループの名前
- -- ID
- ID のみを表示します
例
リソース・グループ example-group
を表示します
ibmcloud resource group example-group
リソース・グループ example-group
の ID のみを表示します
ibmcloud resource group example-group --id
ibmcloud resource group-create
リソース・グループを作成します。
ibmcloud resource group-create NAME
コマンド・オプション
- NAME (必須)
- リソース・グループの名前
例
リソース・グループ example-group
を作成します
ibmcloud resource group-create example-group
ibmcloud resource group-update
既存のリソース・グループを更新します
ibmcloud resource group-update NAME [-n, --name NEW_NAME] [-f, --force]
コマンド・オプション
- NAME (必須)
- ターゲット・リソース・グループの名前
- -n, --name
- リソース・グループの新しい名前
- -f, --force
- 確認を求めずに更新を強制します
例
リソース・グループ example-group
を trial-group
に名前変更します
ibmcloud resource group-update example-group -n trial-group
ibmcloud resource group-delete
既存のリソース・グループを削除します
ibmcloud resource group-delete NAME [-f, --force]
コマンド・オプション
- NAME (必須)
- ターゲット・リソース・グループの名前
- -f, --force
- 確認なしで削除を強制します
例
リソース・グループ example-group
を削除します。
ibmcloud resource group-delete example-group -f
ibmcloud resource quotas
すべての割り当て量定義をリストします。
ibmcloud resource quotas
例
すべての割り当て量定義をリストします
ibmcloud resource quotas
ibmcloud resource quota
割り当て量定義の詳細を表示します。
ibmcloud resource quota NAME
コマンド・オプション
- NAME (必須)
- 割り当て量の名前
例
割り当て量 free
の詳細を表示します
ibmcloud resource quota free
ibmcloud resource service-instances
サービス・インスタンスをリストします。
ibmcloud resource service-instances [--service-name SERVICE_NAME] [--location LOCATION] [--type INSTANCE_TYPE] [-g RESOURCE_GROUP | --all-resource-groups] [--long] [--limit LIMIT] [--offset OFFSET] [--output FORMAT] [-q, --quiet]
コマンド・オプション
- --service-name SERVICE_NAME
- 従属サービスの名前
- --location LOCATION
- ロケーション別のフィルター
- --type INSTANCE_TYPE
- インスタンスのタイプ。
service_instance
タイプは、指定されていない場合に使用されます。 すべてのタイプのインスタンスをリストするには、all を使用します。 - -g RESOURCE_GROUP
- リソース・グループ名
- --all-resource-groups
- すべてのリソース・グループの照会
- --long
- 出力にさらにフィールドを表示
- -- LIMIT の制限
- 返すリソースの数
- -- オフセット OFFSET
- 開始リソース位置番号
- --output FORMAT
- 出力形式を指定します。 現在、JSON のみがサポートされています。
- -q, --quiet
- 詳細出力を抑制します。
例
サービス test-service
のサービス・インスタンスをリストします。
ibmcloud resource service-instances --service-name test-service
ページ・サイズが 10 のサービス・インスタンスの次のページをリストします
ibmcloud resource service-instances --offset 1 --limit 10
ibmcloud resource service-instance
サービス・インスタンスの詳細を表示します。
ibmcloud resource service-instance (NAME|ID) [--location LOCATION] [--id]
コマンド・オプション
- NAME (必須)。ID と同時に指定することはできません。
- サービス・インスタンスの名前
- ID (必須)。NAME と同時に指定することはできません。
- サービス・インスタンスの ID
- -- ロケーション
- ロケーション別のフィルター
- -- ID
- サービス・インスタンスの ID を表示します
例
サービス・インスタンス my-service-instance
の詳細を表示します
ibmcloud resource service-instance my-service-instance
ibmcloud resource service-instance-create
サービス・インスタンスの作成。
ibmcloud resource service-instance-create NAME (SERVICE_NAME | SERVICE_ID) SERVICE_PLAN_NAME LOCATION [-d, --deployment DEPLOYMENT_NAME] [-p, --parameters @JSON_FILE | JSON_STRING ] [-g RESOURCE_GROUP] [--service-endpoints SERVICE_ENDPOINTS_TYPE] [--allow-cleanup] [--lock]
コマンド・オプション
- NAME (必須)
- サービス・インスタンスの名前
- SERVICE_NAME または SERVICE_ID (必須)
- サービスの名前または ID。 サービス・オファリングをリストするには、
ibmcloud catalog service-marketplace
コマンドを使用します。 - SERVICE_PLAN_NAME または SERVICE_PLAN_ID (必須)
- サービス・プランの名前または ID
- LOCATION (必須)
- サービス・インスタンスを作成するターゲットの場所または環境
- -d, --deployment DEPLOYMENT_NAME
- デプロイメントの名前
- -p, --parameters @JSONFILE または JSON_STRING
- サービス・インスタンスを作成するパラメーターの JSON ファイルまたは JSON 文字列
- -g RESOURCE_GROUP
- リソース・グループ名
- --service-endpoints SERVICE_ENDPOINTS_TYPE
- サービス・エンドポイントのタイプ。 指定可能な値は「public」、「private」、「public-and-private」です。 サービス・エンドポイントのデフォルト値は、 IBM Cloud®でサービスによって構成されたタイプです。
- --allow-cleanup
- リージョン・インスタンス削除の呼び出しの処理中にサービス・インスタンスを削除 (クリーンアップ) する必要があるかどうか
- --lock
- ロック状態のサービス・インスタンスを作成するかどうか
例
場所 my-service-instance
でサービス test-service-plan
のサービス・プラン test-service
を使用するサービス・インスタンス eu-gb
を作成します。
ibmcloud resource service-instance-create my-service-instance test-service test-service-plan eu-gb
ibmcloud resource service-instance-update
サービス・インスタンスを更新します。
ibmcloud resource service-instance-update ( NAME | ID ) [-n, --name NEW_NAME] [--service-plan-id SERVICE_PLAN_ID] [-p, --parameters @JSON_FILE | JSON_STRING ] [-g RESOURCE_GROUP] [--service-endpoints SERVICE_ENDPOINTS_TYPE] [-f, --force]
コマンド・オプション
- 名前 (必須)
- サービス・インスタンスの名前。ID と同時に指定することはできません。
- ID (必須)
- サービス・インスタンスの ID。NAME と同時に指定することはできません。
- -n, --name NEW_NAME
- 新規サービス・インスタンス名
- --service-plan-id SERVICE_PLAN_ID
- 新規サービス・プラン ID
- -p, --parameters @JSON_FILE | JSON_STRING
- サービス・インスタンスを作成するパラメーターの JSON ファイルまたは JSON 文字列
- -g RESOURCE_GROUP
- リソース・グループ名
- --service-endpoints SERVICE_ENDPOINTS_TYPE
- サービス・エンドポイントのタイプ。 指定可能な値は「public」、「private」、「public-and-private」です。
- -f, --force
- 確認を求めずに更新を強制します
例
サービス・インスタンス my-service-instance
を更新し、その名前を new-service-instance
に変更します
ibmcloud resource service-instance-update my-service-instance -n new-service-instance
ibmcloud resource service-instance-delete
サービス・インスタンスを削除します。 プロビジョニングが進行中の場合、コマンドはプロビジョニング・プロセスのキャンセルを試行します。 一部のサービスはキャンセルをサポートしていない可能性があります
ibmcloud resource service-instance-delete (NAME|ID) [-f, --force] [--recursive]
コマンド・オプション
- 名前 (必須)
- サービス・インスタンスの名前。ID と同時に指定することはできません。
- ID (必須)
- サービス・インスタンスの ID。NAME と同時に指定することはできません。
- -f, --force
- 確認なしで削除を強制します
- --recursive
- 従属リソースをすべて削除します
例
リソース・サービス・インスタンス my-service-instance
を削除します
ibmcloud resource service-instance-delete my-service-instance
ibmcloud resource service-instance-lock
サービス・インスタンスをロックします。
ibmcloud resource service-instance-lock ( NAME | ID ) [-g RESOURCE_GROUP] [-f, --force]
コマンド・オプション
- 名前 (必須)
- サービス・インスタンスの名前。ID と同時に指定することはできません。
- ID (必須)
- サービス・インスタンスの ID。NAME と同時に指定することはできません。
- -g RESOURCE_GROUP
- リソース・グループ名
- -f, --force
- 確認を求めずにロックを強制します
例
リソース・サービス・インスタンス my-service-instance
をロックします
ibmcloud resource service-instance-lock my-service-instance
ibmcloud resource service-instance-unlock
サービス・インスタンスをロック解除します。
ibmcloud resource service-instance-unlock ( NAME | ID ) [-g RESOURCE_GROUP] [-f, --force]
コマンド・オプション
- 名前 (必須)
- サービス・インスタンスの名前。ID と同時に指定することはできません。
- ID (必須)
- サービス・インスタンスの ID。NAME と同時に指定することはできません。
- -g RESOURCE_GROUP
- リソース・グループ名
- -f, --force
- 確認を求めずにロックを強制します
例
リソース・サービス・インスタンス my-service-instance
をロック解除します
ibmcloud resource service-instance-unlock my-service-instance
ibmcloud resource service-bindings
サービス別名へのバインディングを表示します。
ibmcloud resource service-bindings SERVICE_ALIAS
コマンド・オプション
- SERVICE_ALIAS (必須)
- サービス別名
例
サービス別名 my-service-alias
へのリソース・バインディングを表示します
ibmcloud resource bindings my-service-alias
ibmcloud resource service-binding
サービス・バインディングの詳細を表示します。
ibmcloud resource service-binding ALIAS_NAME [--id]
コマンド・オプション
- ALIAS_NAME (必須)
- サービス別名
- -- ID
- ID を表示します。 このサービス・バインディングの他の出力はすべて抑制されます。 このオプションは、「--output」と同時に指定することはできません。
例
サービス別名 my-service-alias
とアプリ my-app
の間のサービス・バインディングの詳細を表示します
ibmcloud resource bindings my-service-alias my-app
ibmcloud resource service-binding-create
サービス・バインディングを作成します。
ibmcloud resource service-binding-create SERVICE_ALIAS_NAME ROLE_NAME [-n BINDING_NAME] [--service-id SERVICE_ID] [-p, --parameters @JSON_FILE | JSON_TEXT] [--service-endpoint SERVICE_ENDPOINT_TYPE] [-f, --force]
コマンド・オプション
- SERVICE_ALIAS_NAME (必須)
- サービス別名
- ROLE_NAME (必須)
- ユーザー役割の名前
- --service-id SERVICE_ID
- 役割が属しているサービス ID の名前または UUID
- -p, --parameter @JSON_FILE | JSON_TEXT
- パラメーター JSON ファイルまたは JSON 文字列
- --service-endpoint SERVICE_ENDPOINT_TYPE
- サービス・エンドポイントのタイプ。 指定可能な値は、「public」および「private」です。
- -f, --force
- 確認を求めずに作成を強制します
例
my-service-alias
の役割によってサービス別名 my-app
とアプリ Administrator
の間のサービス・バインディングを作成します
ibmcloud resource service-binding-create my-service-alias my-app Administrator
ibmcloud resource service-binding-delete
サービス・バインディングを削除します。
ibmcloud resource service-binding-delete SERVICE_ALIAS [-f, --force]
コマンド・オプション
- SERVICE_ALIAS_NAME (必須)
- サービス別名
- -f, --force
- 確認なしで削除を強制します
例
サービス別名 my-service-alias
とアプリ my-app
の間のサービス・バインディングを削除します。
ibmcloud resource service-binding-delete my-service-alias my-app
ibmcloud resource service-keys
サービス・インスタンスまたはサービス別名のサービス・キーをリストします。
ibmcloud resource service-keys [ --instance-id ID | --instance-name NAME | --alias-id ID | --alias-name NAME ]
コマンド・オプション
- -- instance-id
- サービス・インスタンス ID
- --instance-name
- サービス・インスタンス名
- --alias-id
- サービス別名 ID
- --alias-name
- サービス・エイリアス名
例
サービス・インスタンス my-service-instance
のサービス・キーをリストします
ibmcloud resource service-keys --instance-name my-service-instance
ibmcloud resource service-key
サービス・キー名の最初の n 文字が、指定された KEY_NAME と一致する、任意の数のサービス・キーの詳細を表示します。
ibmcloud resource service-key (NAME | ID) [-g RESOURCE_GROUP] [--id]
コマンド・オプション
- 名前
- キーの名前
- ID
- キーの ID
- -g
- リソース・グループ名
- -- ID
- サービス・キーの ID を表示します。 このオプションは、「--output」と同時に指定することはできません。
- -g RESOURCE_GROUP
- リソース・グループ名
例
サービス・キー my-service-key
の詳細を表示します
ibmcloud resource service-key my-service-key
ID crn:v1:bluemix:public:cloudantnosqldb:us-south:a/537860630a5ba7115be954e8d5aa5689:cc2a6d6c-8f5e-4038-b975-b09b51d1d8dc:resource-key:9057f12e-fbf5-421d-8865-764422217a79
のサービス・キーの詳細を表示します。
ibmcloud resource service-key crn:v1:bluemix:public:cloudantnosqldb:us-south:a/537860630a5ba7115be954e8d5aa5689:cc2a6d6c-8f5e-4038-b975-b09b51d1d8dc:resource-key:9057f12e-fbf5-421d-8865-764422217a79
ibmcloud resource service-key-create
サービス・キーを作成します。
ibmcloud resource service-key-create NAME [ROLE_NAME] ( --instance-id SERVICE_INSTANCE_ID | --instance-name SERVICE_INSTANCE_NAME | --alias-id SERVICE_ALIAS_ID | --alias-name SERVICE_ALIAS_NAME) [--service-id SERVICE_ID] [-p, --parameters @JSON_FILE | JSON_TEXT] [-g RESOURCE_GROUP] [--service-endpoint SERVICE_ENDPOINT_TYPE] [-f, --force] [-f, --force] [-q, --quiet]
コマンド・オプション
- NAME (必須)
- キーの名前。
- ROLE_NAME (オプション)
- IAM サービス役割の名前。 指定された役割をデフォルトのプラットフォーム役割の 1 つにすることはできません。
ibmcloud iam roles --service <your-service>
を実行し、ロールの CRN にserviceRole
が表示されていることを確認することで、このオプションで使用するロールの適格性を確認できます。 - --instance-id SERVICE_INSTANCE_ID
- サービス・インスタンス ID。
- --instance-name SERVICE_INSTANCE_NAME
- サービス・インスタンス名。
- --alias-id SERVICE_ALIAS_ID
- サービス別名 ID。
- --alias-name SERVICE_ALIAS_NAME
- サービス別名。
- --service-id SERVICE_ID
- 役割が属しているサービス ID の名前または UUID。
- -p, --parameters @JSON_FILE | JSON_TEXT
- パラメーター JSON ファイルまたは JSON 文字列。
- -g RESOURCE_GROUP
- リソース・グループ名。
- --service-endpoint SERVICE_ENDPOINT_TYPE
- サービス・エンドポイントのタイプ。 可能な値は「public」または「private」です。
- --output FORMAT (オプション)
- 出力フォーマットを指定します。 JSON のみがサポートされます。
- -f, --force
- 確認を求めずに作成を強制します
- -q, --quite
- 詳細出力を抑制します。
例
役割 my-service-key
を使用して、サービス・インスタンス Administrator
に対して my-service-instance
という名前のサービス・キーを作成します。
ibmcloud resource service-key-create my-service-key Administrator --instance-name my-service-instance
non-iam-enabled サービス・インスタンス my-service-key
の役割を使用せずに、my-service-instance
という名前のサービス・キーを作成します。
ibmcloud resource service-key-create my-service-key --instance-name my-service-instance
ibmcloud resource service-key-update
サービス・キーを更新します。
ibmcloud resource service-key-update ( NAME | ID ) [-n, --name NEW_NAME] [-g RESOURCE_GROUP] [-f, --force]
コマンド・オプション
- NAME | ID
- キーの名前または ID
- -n, --name NEW_NAME
- キーの新しい名前
- -g RESOURCE_GROUP
- キーが属するリソース・グループの ID
- -f, --force
- 確認を求めずに更新を強制します
例
my-service-key
という名前のサービス・キーを更新し、新しい名前 my-service-key-2
を付けます
ibmcloud resource service-key-update my-service-key -n my-service-key-2
ibmcloud resource service-key-delete
サービス・キーを削除します。
ibmcloud resource service-key-delete ( KEY_NAME | KEY_ID ) [-f, --force]
コマンド・オプション
- KEY_NAME | KEY_ID
- キーの名前または ID
- -f, --force
- 確認なしで削除を強制します
例
サービス・キー my-service-key
を削除します
ibmcloud resource service-key-delete my-service-key
ibmcloud resource service-aliases
サービス・インスタンスの別名をリストします。
ibmcloud resource service-aliases [ --instance-id ID | --instance-name NAME ]
コマンド・オプション
- -- instance-id
- 従属サービス・インスタンスの ID
- --instance-name
- 従属サービス・インスタンスの名前
例
サービス・インスタンス my-service-instance
のサービス別名をリストします
ibmcloud resource service-aliases my-service-instance
ibmcloud resource service-alias
サービス別名の詳細を表示します。
ibmcloud resource service-alias ALIAS_NAME [--id]
コマンド・オプション
- ALIAS_NAME (必須)
- サービス別名の名前
- -- ID
- サービス別名の ID を表示します。 この別名の他の出力はすべて抑制されます。 このオプションは、「--output」と同時に指定することはできません。
例
サービス別名 my-service-alias
の詳細を表示します
ibmcloud resource service-alias my-service-alias
ibmcloud resource service-alias-create
サービス・インスタンスの別名を作成します。
ibmcloud resource service-alias-create ALIAS_NAME ( --instance-id ID | --instance-name NAME ) [-s SPACE_NAME] [-t, --tags TAGS] [-p, --parameters @JSON_FILE | JSON_TEXT]
コマンド・オプション
- ALIAS_NAME (必須)
- サービス別名の名前
- -- instance-id
- 従属サービス・インスタンスの ID
- --instance-name
- 従属サービス・インスタンスの名前
- -s
- 別名が作成されるスペースの名前。 デフォルトは現行のスペースです。
- -t, --tags
- タグのリスト。
- -p, --parameters
- パラメーター JSON ファイルまたは JSON 文字列。
例
サービス・インスタンス my-service-alias
のサービス別名 my-service-instance
を作成します。
ibmcloud resource service-alias-create my-service-alias --instance-name my-service-instance
ibmcloud resource service-alias-update
サービス別名を更新します。
ibmcloud resource service-alias-update ALIAS_NAME [-n, --name NEW_NAME] [-t, --tags TAGS] [-p, --parameters @JSON_FILE | JSON_STRING ][-f, --force]
コマンド・オプション
- ALIAS_NAME (必須)
- サービス別名の名前
- -n, --name
- サービス別名の新しい名前。
- -t, --tags
- タグのリスト。
- -p, --parameters
- パラメーター JSON ファイルまたは JSON 文字列。
- -f, --force
- ユーザーの確認を求めずに更新を強制します。
例
サービス別名 my-service-alias
を更新し、その名前を new-service-alias
に変更します
ibmcloud resource service-alias-update my-service-alias -n new-service-alias
ibmcloud resource service-alias-delete
サービス別名を削除します。
ibmcloud resource service-alias-delete ALIAS_NAME [-f, --force]
コマンド・オプション
- ALIAS_NAME (必須)
- サービス別名の名前
- -f, --force
- 確認なしで削除を強制します
例
サービス別名 my-service-alias
を削除します
ibmcloud resource service-alias-delete my-service-alias
ibmcloud resource search
Lucene 照会構文を使用してリソースを検索します。
ibmcloud resource search LUCENE_QUERY [-o, --offset OFFSET] [-l, --limit LIMIT] [-s, --sort-by (name, family, region, type, crn)] [-p, --provider PROVIDER] [-ir, --is-reclaimed (false, true, any)] [--output FORMAT]
コマンド・オプション
- -ir、-- is-reclaimed
- 再利用されたアカウント・リソースを検索します。 デフォルトでは、検索ではアクティブなリソースのみが返されますが、再利用されたかどうかに関係なく、任意のリソースを検索するように「再利用」を設定することができます。 再利用されたリソースにのみ検索条件を適用するには、このオプションを
true
に設定します。 アクティブ・リソースのみを検索するには、このオプションをfalse
に設定します。false
がデフォルトの動作です。 - -o, -offset
- 開始リソース位置番号
- -l, -limit
- 返すリソース数。最大で 10000。
- -s, --sort-by
- ソート基準のプロパティー。 受け入れられる値は、
name
、family
、region
、type
、crn
です。 - -p, --provider
- クラシック・インフラストラクチャー・リソースを表示します。 サポートされる値は
classic-infrastructure
のみです。
検索可能な属性
以下の属性を検索できます。
- 名前
- リソースのユーザー定義名。
- リージョン
- リソースがプロビジョンされている地理的位置。 例: us-south、us-east、au-syd、eu-gb、eu-de、jp-tok。
- service_name
- 「ibmcloud catalog service-marketplace」の出力の名前列に表示されるサービスの名前。
- family
- リソースが属するクラウド・コンポーネント。 許可される値は、containers、resource_controller、vmware、または ims です。
- doc.resource_group_id
- リソース・グループの ID。
- タイプ
- リソース・タイプ。 許可される値は、 k8-cluster、resource-instance、resource-alias、resource-binding、resource-group、vmware-solutions、cloud-objects-storage-infrastructure、block-storage、file-storage、cloud-backup です。
- creation_date
- リソースが作成された日付。
- modification_date
- リソースの最終変更日。 形式は、yyyy-mm-ddThh:mm:ssZ です。
- _objectType
- クラシック・インフラストラクチャー・リソースのタイプ。 許可される値は、SoftLayer_Virtual_DedicatedHost、SoftLayer_Hardware、SoftLayer_Network_Application_Delivery_Controller、SoftLayer_Network_Subnet_IpAddress、SoftLayer_Network_Vlan、SoftLayer_Network_Vlan_Firewall、SoftLayer_Virtual_Guest です。
- tags, tagReferences.tag.name
- リソースにアタッチされているタグ。 クラシック・インフラストラクチャー・リソースにアタッチされているタグを検索する場合は、tagReferences.tag.name を使用します。
例
指定した場所 (つまり us-south リージョン) で、リソース・コントローラーのリソースを検索します。
ibmcloud resource search "region:us-south AND family:resource_controller"
指定した ID を持つリソース・グループ内のリソースまたは別名を検索します。
ibmcloud resource search "(type:resource-instance OR type:resource-alias) AND (doc.resource_group_id:c900d9671b235c00461c5e311a8aeced)"
デフォルトの名前を持つリソース・グループを検索します。
ibmcloud resource search "name:default AND type:resource-group"
指定したサービス名のリソース・バインディングを検索します。
ibmcloud resource search "service_name:cloud-object-storage AND type:resource-binding"
指定したクラウド・リソース名 (CRN) を持つリソースを検索します。
ibmcloud resource search "crn:\"crn:v1:bluemix:public:cloudantnosqldb:us-south:s/4948af7e-cc78-4321-998a-e549dd5e9210:41a031cd-e9e5-4c46-975d-9e4a6391322e:cf-service-instance:\""
指定したタグを持つリソースを検索します。
ibmcloud resource search "tags:\"mykey:myvalue\""
指定した ID を持つクラシック・インフラストラクチャー仮想ゲスト・リソースを検索します (-p classic-infrastructure が指定されている場合のみ)。
ibmcloud resource search "id:12345678 _objectType:SoftLayer_Virtual_Guest"
指定したタグ名を持つクラシック・インフラストラクチャー・ハードウェア・リソースを検索します (-p classic-infrastructure が指定されている場合のみ)。
ibmcloud resource search "tagReferences.tag.name:name _objectType:SoftLayer_Hardware"
ibmcloud resource tag-create
アクセス管理タグを作成します。
ibmcloud resource tag-create --tag-names TAG_NAMES
コマンド・オプション
- --tag-names 値
- タグ名のコンマ区切りリスト。
- -q, --quiet
- 詳細出力を抑制します。
このコマンドは、アクセス管理タグにのみ有効です。 以下に例を示します。
- アクセス管理タグ
project:myproject
を作成するには、以下のコマンドを実行します。ibmcloud resource tag-create —tag-names “project:myproject”
ibmcloud resource tag-attach
1 つ以上のタグをリソースにアタッチします。
ibmcloud resource tag-attach --tag-names TAG_NAMES (--resource-name NAME | --resource-id RESOURCE_ID ) [--resource-type RESOURCE_TYPE] [--tag-type TAG_TYPE] [--account-id ACCOUNT_ID]
コマンド・オプション
- --tag-names 値
- タグ名のコンマ区切りリスト。
- --resource-name 値
- タグをアタッチするリソースの名前。
- --resource-id 値
- タグをアタッチするリソースの CRN (クラシック・インフラストラクチャー・リソースの場合、リソースの ID)。
- --resource-type 値
- タグのタイプ。 許可される値は、user、service、または access のみです (デフォルト値: user)。
- --tag-type 値
- タグのタイプ。 許可される値は、
user
またはservice
のみです。 デフォルト値はuser
です。 - --account-id 値
- タグ付けされるリソースを所有するアカウントの ID (tag-type が service に設定されている場合に必要)。
- -q, --quiet
- 詳細出力を抑制します。
例
-
ユーザー・タグ
MyTag
をMyCluster
という名前の Kubernetes クラスターにアタッチするには、最初に以下のようにして、タグをアタッチしようとしているクラスターの CRN を検索します。ibmcloud resource search 'type:k8\-cluster AND name:MyCluster'
CRN をメモします。CRN は以下の例のようなストリングです。
crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::
タグをアタッチするには、以下のコマンドを実行します。
ibmcloud resource tag-attach --tag-names MyTag --resource-id rn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::
-
ユーザー・タグ
MyTag
をMyResource
という名前のリソースにアタッチするには、以下のようにします。ibmcloud resource tag-attach --tag-name MyTag --resource-name 'MyResource'
-
ユーザー・タグ
MyTag
をMyVM
という名前のクラシック・インフラストラクチャー仮想ゲストにアタッチするには、最初に以下のようにして、タグをアタッチしようとしている仮想ゲストの ID を検索します。ibmcloud resource search 'fullyQualifiedDomainName:MyVM _objectType:SoftLayer_Virtual_Guest' -p classic-infrastructure
ID をメモします。ID は
48373549
のようなストリングです。タグをアタッチするには、以下のコマンドを実行します。
ibmcloud resource tag-attach --tag-names MyTag --resource-id 48373549 --resource-type SoftLayer_Virtual_Guest
-
以前に作成したアクセス管理タグ
project:myproject
をProject data
という IBM Cloud Object Storage のインスタンスにアタッチするには、以下のコマンドを実行します。ibmcloud resource tag-attach --tag-names "project:myproject" --resource-name Project data -—tag-type access
ibmcloud resource tag-detach
1 つ以上のタグをリソースから切り離します。
ibmcloud resource tag-detach --tag-names TAG_NAMES (--resource-name NAME | --resource-id RESOURCE_ID ) [--resource-type RESOURCE_TYPE] [--tag-type TAG_TYPE] [--account-id ACCOUNT_ID]
コマンド・オプション
- --tag-names 値
- タグ名のコンマ区切りリスト。
- --resource-name 値
- タグをアタッチするリソースの名前。
- --resource-id 値
- タグをアタッチするリソースの CRN (クラシック・インフラストラクチャー・リソースの場合、リソースの ID)。
- --resource-type 値
- タグをアタッチするリソース・タイプ (タイプ SoftLayer_Hardware、SoftLayer_Network_Application_Delivery_Controller、SoftLayer_Network_Subnet_IpAddress、または SoftLayer_Network_Vlan のクラシック・インフラストラクチャー・リソースの場合にのみ必要)。
- --tag-type 値
- タグのタイプ。 許可される値は、user、service、または access のみです (デフォルト値: user)。
- --account-id 値
- デタッチされるリソースを所有するアカウントの ID (tag-type が service に設定されている場合に必要)。
- -q, --quiet
- 詳細出力を抑制します。
例
-
ユーザー・タグ
MyTag
をMyCluster
という名前の Kubernetes クラスターからデタッチするには、最初に以下のようにして、タグをデタッチしようとしているクラスターの CRN を検索します。ibmcloud resource search 'type:k8\-cluster AND name:MyCluster'
CRN をメモします。CRN は以下の例のようなストリングです。
crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::
-
タグをデタッチするには、以下のコマンドを実行します。
ibmcloud resource tag-detach --tag-names MyTag --resource-id rn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::
-
ユーザー・タグ
MyTag
をMyResource
という名前のリソースからデタッチするには、以下のようにします。ibmcloud resource tag-detach --tag-name MyTag --resource-name 'MyResource'
-
ユーザー・タグ
MyTag
をMyVM
という名前のクラシック・インフラストラクチャー仮想ゲストからデタッチするには、最初に以下のようにして、タグをデタッチしようとしている仮想ゲストの ID を検索します。ibmcloud resource search 'fullyQualifiedDomainName:MyVM _objectType:SoftLayer_Virtual_Guest' -p classic-infrastructure
ID をメモします。ID は
48373549
のようなストリングです。 -
タグをデタッチするには、以下のコマンドを実行します。
ibmcloud resource tag-detach --tag-names MyTag --resource-id 48373549 --resource-type SoftLayer_Virtual_Guest
-
アクセス管理タグ
project:myproject
をProject data
という IBM Cloud Object Storage のインスタンスからデタッチするには、以下のコマンドを実行します。ibmcloud resource tag-detach --tag-names "project:myproject" --resource-name Project data -—tag-type access
ibmcloud resource tag-delete
タグを削除します。
ibmcloud resource tag-delete (--tag-name TAG_NAME | -a, --all [-f, --force]) [-p, --provider PROVIDER] [--tag-type TAG_TYPE] [--account-id ACCOUNT_ID]
コマンド・オプション
- --tag-name 値
- 削除するタグ名。
- --provider 値, -p 値
- 指定されたプロバイダー内でタグを削除します (サポートされる値は classic-infrastructure のみです)。 タイプが SoftLayer_Hardware、SoftLayer_Network_Application_Delivery_Controller、SoftLayer_Network_Subnet_IpAddress、または SoftLayer_Network_Vlan のリソースにそれを使用します。
- --tag-type 値
- タグのタイプ。 許可される値は、user、service、または access のみです (デフォルト値: user)。
- account-id 値
- 削除されるタグを所有するアカウントの ID (tag-type が service に設定されている場合に必要)。
- --force, -f
- 確認を求めずにタグを削除します。
- --all、-a
- リソースに接続されていないすべてのタグを削除します。
- -q, --quiet
- 詳細出力を抑制します。
タグは、リソースにアタッチされていない場合にのみ削除できます。
例
- ユーザー・タグ
MyTag
をアカウントから削除するには、以下のようにします。ibmcloud resource tag-delete --tag-name "MyTag"
- アクセス管理タグ
project:myproject
をアカウントから削除するには、以下のようにします。ibmcloud resource tag-delete --tag-name "project:myproject" --tag-type access
- 未使用のユーザー・タグをアカウントからすべて削除するには、以下のようにします。
ibmcloud resource tag-delete -a
- 未使用のアクセス管理タグをアカウントからすべて削除するには、以下のようにします。
ibmcloud resource tag-delete -a --tag-type access
ibmcloud resource reclamations
復元または削除できる回収済みリソースをリストします。
ibmcloud resource reclamations [--resource-instance-id INSTANCE_ID]
コマンド・オプション
- --resource-instance-id
- リソース・インスタンスのグローバル一意 ID (GUID)
例
すべてのリソース回収をリストします。
ibmcloud resource reclamations
特定のサービス・インスタンスのリソースの再利用をリストします。
ibmcloud resource reclamations --resource-instance-id abcd1234-ef56-486e-b293-22d6c7eb6699
ibmcloud resource reclamation
リソース回収の詳細を表示します。
ibmcloud resource reclamation RECLAMATION_ID
コマンド・オプション
- RECLAMATION_ID
- リソース回収 ID
例
リソース回収の詳細を表示します。
ibmcloud resource reclamation daf12d343ef
ibmcloud resource reclamation-restore
リソースが再び使用可能になるように回収済みリソースを復元します。
ibmcloud resource reclamation-restore ID [--comment COMMENT]
コマンド・オプション
- ID
- リソース回収 ID
- --comment
- アクションについてのコメント
例
ID が d9fendfwlw
のリソース回収をリストアします。
ibmcloud resource reclamation-restore "d9fendfwlw"
ID d9fendfwlw
を使用してリソースの再利用を復元し、 need to use for another 3 months
のコメントを残し、JSON 出力を表示します:
ibmcloud resource reclamation-restore "d9fendfwlw" --comment "need to use for another 3 months" --output JSON
ibmcloud resource reclamation-delete
リソースを復元不能にするために回収済みリソースを削除します。
ibmcloud resource reclamation-delete ID [--comment COMMENT] [--f, --force]
コマンド・オプション
- ID
- リソース回収 ID
- --comment
- アクションについてのコメント
- -f, --force
- 確認なしで削除を強制します
例
ID が d9fendfwlw
のリソース回収を削除します。
ibmcloud resource reclamation-delete "d9fendfwlw"
ID d9fendfwlw
のリソース再利用を削除し、確認を求めずに no longer needed
のコメントを残します:
ibmcloud resource reclamation-delete "d9fendfwlw" --comment "no longer needed" -f