リソースおよびリソース・グループの処理 (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
1ページあたり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
- --location
- ロケーション別のフィルター
- --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] [--subscription SUBSCRIPTION_ID]
コマンド・オプション
- 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
- ロック状態のサービス・インスタンスを作成するかどうか
- --subscription
- このサービスとプランに関連するサブスクリプションID
例
ロケーション eu-gb 上のサービス test-service のサービスプラン test-service-plan を使用する、 my-service-instance という名前のサービスインスタンスを作成する:
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-keys
サービスインスタンスのサービスキーを一覧表示する。
ibmcloud resource service-keys [ --instance-id ID | --instance-name NAME ]
コマンド・オプション
- --instance-id
- サービス・インスタンス ID
- --instance-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) [--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
- サービス・インスタンス名。
- --service-id SERVICE_ID
- 役割が属しているサービス ID の名前または UUID。
ROLE_NAME省略されているか、Noneに設定されている場合のみ設定可能。 - -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 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
- 再利用されたアカウント・リソースを検索します。 しかし、デフォルトでは、検索はアクティブなリソースのみを返す。 is-reclaimedをanyに設定することで、再利用されているか否かにかかわらずリソースを検索することができる。 再利用されたリソースにのみ検索条件を適用するには、このオプションを
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」の出力の名前列に表示されるサービスの名前。
- creation_date
- リソースが作成された日付。
- modification_date
- リソースの最終変更日。
検索できる属性の完全なリストについては、リソースの検索 を参照してください。
例
指定された場所(つまりus-southリージョン)のリソースコントローラーリソースを検索します:
ibmcloud resource search "region:us-south AND family:resource_controller"
デフォルトの名前を持つリソース・グループを検索します。
ibmcloud resource search "name:default AND type:resource-group"
指定したクラウド・リソース名 (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リソースサブスクリプション
サブスクリプションの詳細を表示する。
ibmcloud resource subscription SUBSCRIPTION_ID
コマンド・オプション
- SUBSCRIPTION_ID (必須)
- サブスクリプションの SUBSCRIPTION_ID フィールド
例
サブスクリプションの詳細を表示 my-subscription-id :
ibmcloud resource subscription my-subscription-id
ibmcloudリソース・サブスクリプション
アカウントのサブスクリプションを一覧表示
ibmcloud resource subscriptions [--output FORMAT]
コマンド・オプション
- --output 値
- 出力フォーマットを指定します。 現在、JSON のみがサポートされています。
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 | --resources-query RESOURCES_QUERY) [--resource-type RESOURCE_TYPE] [--tag-type TAG_TYPE] [--account-id ACCOUNT_ID] [--replace] [--update]
コマンド・オプション
- --tag-names 値
- タグ名のコンマ区切りリスト。
- --resources-query 価値
- タグを付けるべきリソースを検索するためのグローバル検索クエリー文字列
- --resource-name 値
- タグを付けなければならないリソースの名前。
- --resource-id 値
- タグをアタッチするリソースの CRN (クラシック・インフラストラクチャー・リソースの場合、リソースの ID)。
- --resource-type 値
- タグを適用しなければならないリソースタイプ。 これは SoftLayer_Hardware_Server, SoftLayer_Hardware, SoftLayer_Virtual_Guest, SoftLayer_Network_Vlan_Firewall, SoftLayer_Network_Application_Delivery_Controller, SoftLayer_Network_Vlan, SoftLayer_Virtual_DedicatedHost, SoftLayer_Network_Component_Firewall, および SoftLayer_Network_Firewall_Module_Context タイプの クラシック・インフラストラクチャー リソースにのみ必要です。
- --tag-type 値
- タグのタイプ。 許可される値は、
userまたはserviceのみです。 デフォルト値はuserです。 - --account-id 値
- タグ付けされるリソースを所有するアカウントの ID (tag-type が service に設定されている場合に必要)。
- --replace
- タグ名のリストは、リソースに添付されている現在のタグ名のリストを置き換える。
- --update
key:valueという形式のタグ名が更新されます。 このオプションは、その形式ではないタグ名には影響しません。- -q, --quiet
- 詳細出力を抑制します。
例
-
MyClusterという Kubernetes クラスタにmy-tagユーザタグを付けるには、まずクラスタの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 my-tag --resource-id rn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a:: -
MyResourceというリソースに、my-tagというユーザータグを付ける:ibmcloud resource tag-attach --tag-name my-tag --resource-name 'MyResource' -
us-southにデプロイされたすべての Kubernetes クラスターにmy-tag-1とmy-tag-2のユーザー・タグをアタッチするには、次のコマンドを実行します:ibmcloud resource tag-attach --tag-names my-tag-1,my-tag-2 --resources-query 'service_name:containers-kubernetes AND region:us-south'このコマンドはまず、閲覧可能なus-southのすべての Kubernetes クラスターを検索し、その後、指定した2つのタグをそれぞれに付ける。 そして、 Kubernetes クラスターごとに操作の結果を表示する。
-
MyVMという名前のクラシックインフラストラクチャ仮想ゲストにmy-tagユーザータグをアタッチするには、仮想ゲストの ID を特定します:ibmcloud resource search 'fullyQualifiedDomainName:MyVM _objectType:SoftLayer_Virtual_Guest' -p classic-infrastructureID をメモします。ID は
48373549のようなストリングです。タグをアタッチするには、以下のコマンドを実行します。
ibmcloud resource tag-attach --tag-names my-tag --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 -
MyResourceという名前のリソースのenvユーザー・タグの値をproductionに更新するには、以下のコマンドを実行します。ibmcloud resource tag-attach --tag-names 'env:production' --resource-name 'MyResource' --update -
MyResourceという名前のリソースでenvアクセス管理タグの値をproductionに更新するには、次のコマンドを実行します。ibmcloud resource tag-attach --tag-names 'env:production' --resource-name 'MyResource' --update --tag-type access -
MyResourceのすべてのユーザー・タグを新しいタグ・セットtag1、tag2、およびtag3で置き換えるには、以下のコマンドを実行します。ibmcloud resource tag-attach --tag-names 'tag1,tag2,tag3' --resource-name 'MyResource' --replace -
MyResourceのすべてのアクセス管理タグをタグcompliance:hipaaで置き換えるには、以下のコマンドを実行します。ibmcloud resource tag-attach --tag-names 'compliance:hipaa' --resource-name 'MyResource' --replace --tag-type access
ibmcloud resource tag-detach
1 つ以上のタグをリソースから切り離します。
ibmcloud resource tag-detach --tag-names TAG_NAMES (--resource-name NAME | --resource-id RESOURCE_ID | --resources-query RESOURCES_QUERY) [--resource-type RESOURCE_TYPE] [--tag-type TAG_TYPE] [--account-id ACCOUNT_ID]
コマンド・オプション
- --tag-names 値
- タグ名のコンマ区切りリスト。
- --resources-query 価値
- タグを切り離すべきリソースを検索するグローバル検索クエリー文字列
- --resource-name 値
- タグを付けるリソースの名前。
- --resource-id 値
- タグをアタッチするリソースの CRN (クラシック・インフラストラクチャー・リソースの場合、リソースの ID)。
- --resource-type 値
- タグを削除しなければならないリソースタイプ。 これは SoftLayer_Hardware_Server, SoftLayer_Hardware, SoftLayer_Virtual_Guest, SoftLayer_Network_Vlan_Firewall, SoftLayer_Network_Application_Delivery_Controller, SoftLayer_Network_Vlan, SoftLayer_Virtual_DedicatedHost, SoftLayer_Network_Component_Firewall, および SoftLayer_Network_Firewall_Module_Context タイプの クラシック・インフラストラクチャー リソースにのみ必要です。
- --tag-type 値
- タグのタイプ。 許可される値は、user、service、accessのみです(デフォルト値:user)。
- --account-id 値
- デタッチされるリソースを所有するアカウントの ID (tag-type が service に設定されている場合に必要)。
- -q, --quiet
- 詳細出力を抑制します。
例
-
MyClusterという名前の Kubernetes クラスタからmy-tagユーザタグを切り離すには、まずクラスタの 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 my-tag --resource-id crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a:: -
MyResourceというリソースからmy-tagというユーザータグを切り離すには:ibmcloud resource tag-detach --tag-name my-tag --resource-name 'MyResource' -
us-southにデプロイされたすべての Kubernetes クラスターからユーザー・タグmy-tag-1とmy-tag-2を切り離すには、次のコマンドを実行します:ibmcloud resource tag-detach --tag-names my-tag-1,my-tag-2 --resources-query 'service_name:containers-kubernetes AND region:us-south'このコマンドは、まず、閲覧可能なus-southのすべての Kubernetes クラスターを検索し、その後、それぞれから指定された2つのタグを切り離す。 そして、 Kubernetes クラスターごとに操作の結果を表示する。
-
MyVMという名前のクラシック・インフラストラクチャー仮想ゲストからmy-tagユーザータグを切り離すには、まずタグを切り離したい仮想ゲストの ID を探します:ibmcloud resource search 'fullyQualifiedDomainName:MyVM _objectType:SoftLayer_Virtual_Guest' -p classic-infrastructureID をメモします。ID は
48373549のようなストリングです。タグをデタッチするには、以下のコマンドを実行します。
ibmcloud resource tag-detach --tag-names my-tag --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 -
MyResourceからenv:valueタグを切り離すには、その値に関係なく、以下のコマンドを実行します。ibmcloud resource tag-detach --tag-names 'env:*' —resource-name 'MyResource' -
MyResourceからすべてのタグを切り離すには、次のコマンドを実行します。ibmcloud resource tag-detach --tag-names '*' —resource-name 'MyResource'
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である。 コマンドを使用して、 クラシック・インフラストラクチャー タグを削除します。
- --tag-type 値
- タグのタイプ。 許可される値は、user、service、accessのみです(デフォルト値:user)。
- account-id 値
- 削除されるタグを所有するアカウントの ID (tag-type が service に設定されている場合に必要)。
- --force, -f
- 確認を求めずにタグを削除します。
- --all, -a
- リソースにアタッチされていないタグをすべて削除する。
- -q, --quiet
- 詳細出力を抑制します。
タグは、リソースにアタッチされていない場合にのみ削除できます。
例
- アカウントからユーザータグ
my-tagを削除するには:ibmcloud resource tag-delete --tag-name "my-tag" - アクセス管理タグ
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