Trabalhando com recursos e grupos de recursos (ibmcloud resource)
Um grupo de recursos é uma maneira para organizar os recursos da conta em agrupamentos customizáveis. Use os comandos a seguir por meio da interface da linha de comandos da IBM Cloud® para gerenciar os recursos da IBM Cloud em um grupo de recursos.
ibmcloud resource groups
Listar grupos de recursos.
ibmcloud resource groups [--default]
Opções de comando
- --default
- Obter o grupo padrão da conta atual.
Exemplos
Listar todos os grupos de recursos sob a conta destinada atualmente:
ibmcloud resource groups
Liste o grupo padrão da conta de destino atual:
ibmcloud resource groups --default
ibmcloud resource group
Mostrar detalhes de um grupo de recursos
ibmcloud resource group NAME [--id]
Opções de comando
- NAME (necessário)
- Nome do grupo de recursos
- --id
- Mostrar somente o ID
Exemplos
Mostre o grupo de recursos example-group:
ibmcloud resource group example-group
Mostre apenas o ID do grupo de recursos example-group:
ibmcloud resource group example-group --id
ibmcloud resource group-create
Crie um grupo de recursos:
ibmcloud resource group-create NAME
Opções de comando
- NAME (necessário)
- Nome do grupo de recursos
Exemplos
Crie um grupo de recursos example-group:
ibmcloud resource group-create example-group
ibmcloud resource group-update
Atualizar um grupo de recursos existente
ibmcloud resource group-update NAME [-n, --name NEW_NAME] [-f, --force]
Opções de comando
- NAME (necessário)
- Nome do grupo de recursos de destino
- -n, --name
- Novo nome do grupo de recursos
- -f, --force
- Forçar atualização sem confirmação
Exemplos
Renomeie o grupo de recursos example-group para trial-group:
ibmcloud resource group-update example-group -n trial-group
ibmcloud resource group-delete
Excluir um grupo de recursos existente
ibmcloud resource group-delete NAME [-f, --force]
Opções de comando
- NAME (necessário)
- Nome do grupo de recursos de destino
- -f, --force
- Forçar exclusão sem confirmação
Exemplos
Excluir grupo de recursos example-group:
ibmcloud resource group-delete example-group -f
ibmcloud resource quotas
Listar todas as definições de cota.
ibmcloud resource quotas
Exemplos
Liste todas as definições de cota:
ibmcloud resource quotas
Cota de recurso ibmcloud
Mostrar detalhes de uma definição de cota.
ibmcloud resource quota NAME
Opções de comando
- NAME (necessário)
- Nome da cota
Exemplos
Mostrar detalhes da cota free:
ibmcloud resource quota free
ibmcloud resource service-instances
Listar instâncias de serviço.
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]
Opções de comando
- --service-name SERVICE_NAME
- Nome do pertencente ao serviço
- --location LOCATION
- Filtrar por local
- --type INSTANCE_TYPE
- Tipo de instâncias. O tipo
service_instanceé usado se não especificado. Use todos para listar todos os tipos de instâncias - -g RESOURCE_GROUP
- Nome do grupo de recursos
- --all-resource-groups
- Consultar todos os grupos de recursos
- --long
- Mostrar mais campos na saída
- --limit LIMITE
- Número de recursos a serem devolvidos
- --offset DESLOCAMENTO
- Iniciando o número da posição de recursos
- --output FORMAT
- Especificar o formato de saída. Apenas JSON é suportado agora.
- -q, --quiet
- Suprimir a saída detalhada.
Exemplos
Liste instâncias de serviço do serviço test-service:
ibmcloud resource service-instances --service-name test-service
Liste a próxima página de instâncias de serviço com 10 registros por página.
ibmcloud resource service-instances --offset 1 --limit 10
ibmcloud resource service-instance
Mostrar detalhes de uma instância de serviço.
ibmcloud resource service-instance (NAME|ID) [--location LOCATION] [--id]
Opções de comando
- NAME (obrigatório), exclusivo com ID
- Nome da instância de serviço
- ID (obrigatório), exclusivo com NAME
- ID da instância de serviço
- --location
- Filtrar por local
- --id
- Exibir a ID da instância de serviço
Exemplos
Mostrar detalhes de serviço da instância my-service-instance:
ibmcloud resource service-instance my-service-instance
ibmcloud resource service-instance-create
Crie uma instância de serviço.
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]
Opções de comando
- NAME (necessário)
- Nome da instância de serviço
- SERVICE_NAME ou SERVICE_ID (necessário)
- Nome ou ID do serviço. Para listar as ofertas de serviços, use o endereço
ibmcloud catalog service-marketplacecomando. - SERVICE_PLAN_NAME ou SERVICE_PLAN_ID (necessário)
- Nome ou ID do plano de serviço
- LOCATION (necessário)
- Local ou ambiente de destino para criar a instância de serviço
- -d, --deployment DEPLOYMENT_NAME
- Nome da implementação
- -p, --parameters @JSONFILE ou JSON_STRING
- Arquivo JSON ou sequência JSON de parâmetros para criar a instância de serviço
- -g RESOURCE_GROUP
- Nome do grupo de recursos
- --service-endpoints SERVICE_ENDPOINTS_TYPE
- Tipos de pontos de extremidade de serviço conforme permitido pela definição do serviço. Os valores típicos são "público", "privado", "público e privado". O valor padrão para pontos de extremidade de serviço é o tipo configurado pelo serviço em IBM Cloud®.
- --allow-cleanup
- Se a instância de serviço deve ser excluída (limpa) durante o processamento de uma chamada de exclusão de instância de região
- --lock
- Se a instância de serviço deve ser criada com o estado bloqueado
- --subscription
- ID da assinatura associada a esse serviço e plano
Exemplos
Crie uma instância de serviço chamada my-service-instance que use o plano de serviço test-service-plan do serviço test-service no local eu-gb:
ibmcloud resource service-instance-create my-service-instance test-service test-service-plan eu-gb
ibmcloud resource service-instance-update
Atualizar instância de serviço.
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]
Opções de comando
- Nome (obrigatório)
- Nome da instância de serviço, exclusivo com ID
- ID (obrigatório)
- ID da instância de serviço, exclusivo com NAME
- -n, --name NEW_NAME
- Novo nome da instância de serviço
- --service-plan-id SERVICE_PLAN_ID
- Novo ID do plano de serviço
- -p, --parameters @JSON_FILE | JSON_STRING
- Arquivo JSON ou sequência JSON de parâmetros para criar a instância de serviço
- -g RESOURCE_GROUP
- Nome do grupo de recursos
- --service-endpoints SERVICE_ENDPOINTS_TYPE
- Tipos dos terminais de serviço. Os valores possíveis são 'public', 'private', 'public-and-private'.
- -f, --force
- Forçar atualização sem confirmação
Exemplos
Atualize a instância de serviço my-service-instance, mude o seu nome para new-service-instance:
ibmcloud resource service-instance-update my-service-instance -n new-service-instance
ibmcloud resource service-instance-delete
Exclua a instância de serviço. Se o fornecimento estiver em andamento, o comando tentem cancelar o processo de fornecimento. Alguns serviços podem não suportar cancelamento.
ibmcloud resource service-instance-delete (NAME|ID) [-f, --force] [--recursive]
Opções de comando
- Nome (obrigatório)
- Nome da instância de serviço, exclusivo com ID
- ID (obrigatório)
- ID da instância de serviço, exclusivo com NAME
- -f, --force
- Forçar exclusão sem confirmação
- --recursive
- Excluir todos os recursos pertencentes
Exemplos
Excluir instância de serviço de recurso-instância my-service-instance:
ibmcloud resource service-instance-delete my-service-instance
ibmcloud resource service-instance-lock
Bloquear a instância de serviço.
ibmcloud resource service-instance-lock ( NAME | ID ) [-g RESOURCE_GROUP] [-f, --force]
Opções de comando
- Nome (obrigatório)
- Nome da instância de serviço, exclusivo com ID
- ID (obrigatório)
- ID da instância de serviço, exclusivo com NAME
- -g RESOURCE_GROUP
- Nome do grupo de recursos
- -f, --force
- Forçar o bloqueio sem confirmação
Exemplos
Bloquear a instância de serviço do recurso my-service-instance:
ibmcloud resource service-instance-lock my-service-instance
ibmcloud resource service-instance-unlock
Desbloqueie a instância do serviço.
ibmcloud resource service-instance-unlock ( NAME | ID ) [-g RESOURCE_GROUP] [-f, --force]
Opções de comando
- Nome (obrigatório)
- Nome da instância de serviço, exclusivo com ID
- ID (obrigatório)
- ID da instância de serviço, exclusivo com NAME
- -g RESOURCE_GROUP
- Nome do grupo de recursos
- -f, --force
- Forçar o bloqueio sem confirmação
Exemplos
Desbloquear a instância de serviço do recurso my-service-instance:
ibmcloud resource service-instance-unlock my-service-instance
ibmcloud resource service-keys
Lista as chaves de serviço da instância de serviço.
ibmcloud resource service-keys [ --instance-id ID | --instance-name NAME ]
Opções de comando
- --instance-id
- ID da instância de serviço
- --instance-name
- Nome da instância de serviço
Exemplos
Liste chaves de serviço da instância de serviço my-service-instance:
ibmcloud resource service-keys --instance-name my-service-instance
ibmcloud resource service-key
Exibe os detalhes de qualquer número de chaves de serviço, em que os primeiros n caracteres do nome da chave de serviço correspondem ao KEY_NAME fornecido.
ibmcloud resource service-key (NAME | ID) [-g RESOURCE_GROUP] [--id]
Opções de comando
- NOME
- Nome da chave
- ID
- ID da chave
- -g
- Nome do grupo de recursos
- --id
- Exibir a ID da chave de serviço. Essa opção é exclusiva com '--output'.
- -g RESOURCE_GROUP
- Nome do grupo de recursos
Exemplos
Mostrar detalhes das chaves de serviço my-service-key:
ibmcloud resource service-key my-service-key
Show details of service key with 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
Crie uma chave de serviço.
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]
Opções de comando
- NAME (necessário)
- Nome da chave.
- ROLE_NAME (opcional)
- Nome da função de serviço IAM. A função especificada não pode ser um dos papéis da plataforma padrão. Você pode verificar a elegibilidade de qualquer função para uso com essa opção executando
ibmcloud iam roles --service <your-service>e verificando seserviceRoleaparece no CRN da função. - --instance-id SERVICE_INSTANCE_ID
- ID da instância de serviço.
- --instance-name SERVICE_INSTANCE_NAME
- Nome da instância de serviço.
- --service-id SERVICE_ID
- Nome ou UUID do ID de serviço, ao qual a função pertence. Pode ser definido somente quando
ROLE_NAMEé omitido ou definido comoNone. - -p, --parameters @JSON_FILE | JSON_TEXT
- Arquivo JSON ou sequência JSON de parâmetros.
- -g RESOURCE_GROUP
- Nome do grupo de recursos.
- --service-endpoint SERVICE_ENDPOINT_TYPE
- Tipo do terminal em serviço. Os valores possíveis são 'public' ou 'private'.
- --output FORMAT (opcional)
- Especificar o formato de saída. Somente JSON é suportado.
- -f, --force
- Forçar a criação sem confirmação
- -q, --quite
- Suprimir a saída detalhada.
Exemplos
Crie uma chave de serviço denominada my-service-key com a função Administrator para a instância de serviço my-service-instance:
ibmcloud resource service-key-create my-service-key Administrator --instance-name my-service-instance
Crie uma chave de serviço denominada my-service-key sem nenhuma função para uma instância de serviço não ativada para IAM my-service-instance:
ibmcloud resource service-key-create my-service-key --instance-name my-service-instance
ibmcloud resource service-key-update
Atualizar uma chave de serviço.
ibmcloud resource service-key-update ( NAME | ID ) [-n, --name NEW_NAME] [-g RESOURCE_GROUP] [-f, --force]
Opções de comando
- NAME | ID
- Nome ou ID da chave
- -n, --name NEW_NAME
- Novo nome da chave
- -g RESOURCE_GROUP
- ID do grupo de recursos ao qual a chave pertence
- -f, --force
- Forçar atualização sem confirmação
Exemplos
Atualize uma chave de serviço denominada my-service-key, dê a ela um novo nome my-service-key-2:
ibmcloud resource service-key-update my-service-key -n my-service-key-2
ibmcloud resource service-key-delete
Excluir uma chave de serviço.
ibmcloud resource service-key-delete ( KEY_NAME | KEY_ID ) [-f, --force]
Opções de comando
- KEY_NAME | KEY_ID
- Nome da chave ou o ID da chave
- -f, --force
- Forçar exclusão sem confirmação
Exemplos
Excluir a chave de serviço my-service-key:
ibmcloud resource service-key-delete my-service-key
ibmcloud resource search
Procure recursos usando a sintaxe de consulta do 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]
Opções de comando
- -ir, --is-reclaimed
- Procurar por recursos de contas que foram rereclamados. No entanto, por padrão, a pesquisa retorna apenas recursos ativos. Você pode definir is-reclaimed como any para procurar recursos, sejam eles recuperados ou não. Configure esta opção
para
truepara aplicar os critérios de pesquisa apenas para repor recursos. Configure esta opção parafalsepara pesquisar apenas por recursos ativos.falseé o comportamento padrão. - -o, -offset
- Iniciando o número da posição de recursos
- -l, -limit
- Número de recursos a retornar, até um máximo de 10.000.
- -s, --sort-by
- Propriedade a classificar por. Os valores aceitos são
name,family,region,type,crn. - -p, --provider
- Exibir recursos de infraestrutura clássica. O único valor suportado é
classic-infrastructure.
Atributos pesquisáveis
Você pode pesquisar por vários atributos para ampliar sua pesquisa. Alguns exemplos são:
- nome
- O nome definido pelo usuário do recurso.
- região
- A localização geográfica na qual o recurso é provisionado. Por exemplo: us-south, us-east, au-syd, eu-gb, eu-de e jp-tok.
- service_name
- O nome do serviço como aparece na coluna Nome da saída de 'ibmcloud catalog service-marketplace'.
- creation_date
- A data na qual o recurso é criado.
- modification_date
- A data da última modificação do recurso.
Para obter a lista completa de atributos que você pode pesquisar, consulte Pesquisa de recursos.
Exemplos
Pesquise os recursos do Resource Controller no local especificado (ou seja, na região sul dos EUA):
ibmcloud resource search "region:us-south AND family:resource_controller"
Procurar por grupos de recursos com o nome padrão:
ibmcloud resource search "name:default AND type:resource-group"
Procurar por um recurso com o Cloud Resource Name (CRN) especificado:
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:\""
Procurar por um recurso com a tag especificada:
ibmcloud resource search "tags:\"mykey:myvalue\""
Procure o recurso de Guest virtual de infraestrutura clássica com o ID especificado (somente com infraestrutura clássica -p):
ibmcloud resource search "id:12345678 _objectType:SoftLayer_Virtual_Guest"
Procure o recurso de Hardware de infraestrutura clássica com o nome de tag especificado (somente com infraestrutura clássica -p):
ibmcloud resource search "tagReferences.tag.name:name _objectType:SoftLayer_Hardware"
assinatura de recursos do ibmcloud
Mostrar detalhes de uma assinatura.
ibmcloud resource subscription SUBSCRIPTION_ID
Opções de comando
- SUBSCRIPTION_ID (obrigatório)
- Campo SUBSCRIPTION_ID de uma assinatura
Exemplos
Mostrar detalhes da assinatura my-subscription-id:
ibmcloud resource subscription my-subscription-id
assinaturas de recursos do ibmcloud
Liste as assinaturas de sua conta
ibmcloud resource subscriptions [--output FORMAT]
Opções de comando
- --output value
- Especificar o formato de saída. Apenas JSON é suportado agora.
ibmcloud resource tag-create
Criar uma tag de gerenciamento de acesso:
ibmcloud resource tag-create --tag-names TAG_NAMES
Opções de comando
- --tag-names value
- Lista separada por vírgula de nomes de tag.
- -q, --quiet
- Suprimir a saída detalhada.
Este comando é válido apenas para tags de gerenciamento de acesso. Por exemplo:
- Execute o comando a seguir para criar a tag de gerenciamento de acesso
project:myproject:ibmcloud resource tag-create —tag-names “project:myproject”
ibmcloud resource tag-attach
Conecte uma ou mais tags a um recurso:
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]
Opções de comando
- --tag-names value
- Lista separada por vírgula de nomes de tag.
- --resources-query valor
- Cadeia de caracteres de consulta da Pesquisa Global para recuperar os recursos nos quais as tags devem ser anexadas
- --resource-name value
- O nome do recurso no qual as tags devem ser anexadas.
- --resource-id value
- CRN do recurso ao qual as tags devem ser anexadas (para recurso de Infraestrutura clássica, é o ID do recurso).
- --resource-type value
- Tipo de recurso ao qual as tags devem ser aplicadas. Isso é necessário somente para os recursos da Infraestrutura Clássica dos seguintes tipos: 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, e SoftLayer_Network_Firewall_Module_Context.
- --tag-type value
- O tipo da tag. Os únicos valores permitidos são
userouservice. O valor padrão éuser. - --account-id value
- O ID da conta que possui os recursos a serem identificados (necessário se tag-type é configurado como service).
- --replace
- A lista de nomes de tags substitui a lista atual de nomes de tags que estão anexados ao recurso.
- --update
- Os nomes de tag no formato
key:valueserão atualizados A opção não tem efeito sobre os nomes de tag que não estão nesse formato - -q, --quiet
- Suprimir a saída detalhada.
Exemplos
-
Para anexar a tag de usuário
my-taga um cluster Kubernetes chamadoMyCluster, primeiro identifique o CRN do cluster:ibmcloud resource search 'type:k8\-cluster AND name:MyCluster'Tome nota do CRN, que é uma sequência semelhante ao exemplo a seguir:
crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::Para anexar a tag, execute o comando a seguir:
ibmcloud resource tag-attach --tag-names my-tag --resource-id rn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a:: -
Para anexar a tag de usuário
my-taga um recurso chamadoMyResource:ibmcloud resource tag-attach --tag-name my-tag --resource-name 'MyResource' -
Para anexar as tags de usuário
my-tag-1emy-tag-2a todos os clusters Kubernetes implantados emus-south, execute o seguinte comando:ibmcloud resource tag-attach --tag-names my-tag-1,my-tag-2 --resources-query 'service_name:containers-kubernetes AND region:us-south'O comando inicialmente recupera todos os clusters Kubernetes em us-south que você pode visualizar e, em seguida, anexa as duas tags especificadas a cada um deles. Em seguida, ele exibe o resultado da operação para cada cluster Kubernetes.
-
Para anexar a tag de usuário
my-taga um convidado virtual de infraestrutura clássica chamadoMyVM, identifique o ID do convidado virtual:ibmcloud resource search 'fullyQualifiedDomainName:MyVM _objectType:SoftLayer_Virtual_Guest' -p classic-infrastructureAnote o ID, que é uma sequência semelhante a
48373549.Para anexar a tag, execute o comando a seguir:
ibmcloud resource tag-attach --tag-names my-tag --resource-id 48373549 --resource-type SoftLayer_Virtual_Guest -
Para anexar a tag de gerenciamento de acesso
project:myproject, que você criou anteriormente, a uma instância do IBM Cloud Object Storage chamadaProject data, execute o comando a seguir:ibmcloud resource tag-attach --tag-names "project:myproject" --resource-name Project data -—tag-type access -
Para atualizar para
productiono valor da tag do usuárioenvem um recurso denominadoMyResource, execute o comando a seguir:ibmcloud resource tag-attach --tag-names 'env:production' --resource-name 'MyResource' --update -
Para atualizar para
productiono valor da tag de gerenciamento de acessoenvem um recurso denominadoMyResource, execute o comando a seguir:ibmcloud resource tag-attach --tag-names 'env:production' --resource-name 'MyResource' --update --tag-type access -
Para substituir todas as tags de usuário do
MyResourcepor um novo conjunto de tagstag1,tag2etag3, execute o comando a seguir:ibmcloud resource tag-attach --tag-names 'tag1,tag2,tag3' --resource-name 'MyResource' --replace -
Para substituir todas as tags de gerenciamento de acesso de
MyResourcepela tagcompliance:hipaa, execute o comando a seguir:ibmcloud resource tag-attach --tag-names 'compliance:hipaa' --resource-name 'MyResource' --replace --tag-type access
ibmcloud resource tag-detach
Desconectando uma ou mais tags de um recurso:
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]
Opções de comando
- --tag-names value
- Lista separada por vírgula de nomes de tag.
- --resources-query valor
- Cadeia de caracteres de consulta da Pesquisa Global para recuperar os recursos nos quais as tags devem ser desanexadas
- --resource-name value
- O nome do recurso no qual as tags devem ser anexadas.
- --resource-id value
- CRN do recurso ao qual as tags devem ser anexadas (para recurso de Infraestrutura clássica, é o ID do recurso).
- --resource-type value
- Tipo de recurso no qual as tags devem ser removidas. Isso é necessário somente para os recursos da Infraestrutura Clássica dos seguintes tipos: 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, e SoftLayer_Network_Firewall_Module_Context.
- --tag-type value
- Tipo da tag. Os únicos valores permitidos são: usuário, serviço ou acesso (valor padrão: usuário).
- --account-id value
- O ID da conta que possui os recursos a serem removidos (necessário se tag-type é configurado como service).
- -q, --quiet
- Suprimir a saída detalhada.
Exemplos
-
Para desanexar a tag de usuário
my-tagde um cluster Kubernetes chamadoMyCluster, primeiro identifique o CRN do cluster:ibmcloud resource search 'type:k8\-cluster AND name:MyCluster'Tome nota do CRN, que é uma sequência semelhante ao exemplo a seguir:
crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a::Para remover a tag, execute o comando a seguir:
ibmcloud resource tag-detach --tag-names my-tag --resource-id crn:v1:bluemix:public:containers-kubernetes:us-south:a/a27a4741a57dcf5c965939adb66fe1c7:a46242e638ca47b09f10e9a3cbe5687a:: -
Para desanexar a tag de usuário
my-tagde um recurso chamadoMyResource:ibmcloud resource tag-detach --tag-name my-tag --resource-name 'MyResource' -
Para desanexar as tags de usuário
my-tag-1emy-tag-2de todos os clusters Kubernetes implantados emus-south, execute o seguinte comando:ibmcloud resource tag-detach --tag-names my-tag-1,my-tag-2 --resources-query 'service_name:containers-kubernetes AND region:us-south'Inicialmente, o comando recupera todos os clusters Kubernetes em us-south que você pode visualizar e, em seguida, remove as duas tags especificadas de cada um. Em seguida, ele exibe o resultado da operação para cada cluster Kubernetes.
-
Para desanexar a tag de usuário
my-tagde um convidado virtual de infraestrutura clássica chamadoMyVM, primeiro procure o ID do convidado virtual do qual você gostaria de desanexar a tag:ibmcloud resource search 'fullyQualifiedDomainName:MyVM _objectType:SoftLayer_Virtual_Guest' -p classic-infrastructureAnote o ID, que é uma sequência semelhante a
48373549.Para remover a tag, execute o comando a seguir:
ibmcloud resource tag-detach --tag-names my-tag --resource-id 48373549 --resource-type SoftLayer_Virtual_Guest -
Para remover a tag de gerenciamento de acesso
project:myprojectde uma instância do IBM Cloud Object Storage chamadaProject data, execute o comando a seguir:ibmcloud resource tag-detach --tag-names "project:myproject" --resource-name Project data -—tag-type access -
Para remover a tag
env:valuedeMyResource, independentemente de seu valor, execute o comando a seguir:ibmcloud resource tag-detach --tag-names 'env:*' —resource-name 'MyResource' -
Para remover todas as tags do
MyResource, execute o comando a seguir:ibmcloud resource tag-detach --tag-names '*' —resource-name 'MyResource'
ibmcloud resource tag-delete
Excluir uma tag:
ibmcloud resource tag-delete (--tag-name TAG_NAME | -a, --all [-f, --force]) [-p, --provider PROVIDER] [--tag-type TAG_TYPE] [--account-id ACCOUNT_ID]
Opções de comando
- --tag-name value
- O nome de tag a ser excluído.
- --provider value, -p value
- Exclui as tags associadas ao provedor especificado. O único valor permitido é: classic-infrastructure. Use o comando para excluir as tags de infraestrutura clássica.
- --tag-type value
- Tipo da tag. Os únicos valores permitidos são: usuário, serviço ou acesso (valor padrão: usuário).
- account-id value
- O ID da conta que possui as tags a serem excluídas (necessário se tag-type é configurado como service).
- --force, -f
- Excluir as tags sem confirmação.
- --all, -a
- Exclua todas as tags que não estão anexadas a nenhum recurso.
- -q, --quiet
- Suprimir a saída detalhada.
Uma tag poderá ser excluída somente se não estiver anexada a nenhum recurso.
Exemplos
- Para excluir a tag de usuário
my-tagda conta:ibmcloud resource tag-delete --tag-name "my-tag" - Para excluir a tag de gerenciamento de acesso
project:myprojectda conta:ibmcloud resource tag-delete --tag-name "project:myproject" --tag-type access - Para excluir todas as tags do usuário não usadas da conta:
ibmcloud resource tag-delete -a - Para excluir todas as tags de gerenciamento de acesso não usadas da conta:
ibmcloud resource tag-delete -a --tag-type access
ibmcloud resource reclamations
Listar recursos recuperados que podem ser restaurados ou excluídos:
ibmcloud resource reclamations [--resource-instance-id INSTANCE_ID]
Opções de comando
- --resource-instance-id
- O ID globalmente exclusivo (GUID) da instância de recurso
Exemplos
Listar todas as recuperações de recurso:
ibmcloud resource reclamations
Listar as recuperações de recurso de uma determinada instância de serviço:
ibmcloud resource reclamations --resource-instance-id abcd1234-ef56-486e-b293-22d6c7eb6699
ibmcloud resource reclamation
Mostrar detalhes de uma recuperação de recurso:
ibmcloud resource reclamation RECLAMATION_ID
Opções de comando
- RECLAMATION_ID
- ID de recuperação de recurso
Exemplos
Mostrar detalhes de uma recuperação de recurso:
ibmcloud resource reclamation daf12d343ef
ibmcloud resource reclamation-restore
O período de tempo em que um recurso excluído pode ser recuperado depende do serviço envolvido. Verifique a documentação específica do serviço para determinar o suporte do serviço para recuperação e, se houver suporte, o período de recuperação.
Restaurar um recurso recuperado para que o recurso esteja disponível novamente:
ibmcloud resource reclamation-restore ID [--comment COMMENT]
Opções de comando
- ID
- ID da recuperação de recurso
- --comment
- Comentários sobre a ação
Exemplos
Restaurar uma recuperação de recurso com ID d9fendfwlw:
ibmcloud resource reclamation-restore "d9fendfwlw"
Restaure uma recuperação de recursos com o ID d9fendfwlw, deixe um comentário de need to use for another 3 monthse mostre saída JSON:
ibmcloud resource reclamation-restore "d9fendfwlw" --comment "need to use for another 3 months" --output JSON
ibmcloud resource reclamation-delete
Excluir um recurso recuperado para que o recurso não possa mais ser restaurado:
ibmcloud resource reclamation-delete ID [--comment COMMENT] [--f, --force]
Opções de comando
- ID
- ID da recuperação de recurso
- --comment
- Comentários sobre a ação
- -f, --force
- Forçar exclusão sem confirmação
Exemplos
Excluir uma recuperação de recurso com o ID d9fendfwlw:
ibmcloud resource reclamation-delete "d9fendfwlw"
Exclua uma recuperação de recursos com ID d9fendfwlw e deixe um comentário de no longer needed sem confirmação:
ibmcloud resource reclamation-delete "d9fendfwlw" --comment "no longer needed" -f