Esempi

ibmcloud project select db4da927-80bc-4161-960d-7ce2b5e1be96

In alternativa, è possibile selezionare per nome del progetto

ibmcloud project select ProjectA

Per deselezionare un progetto

ibmcloud project select --unset-project

Opzioni comando

--unset-project (bool)

Progetto mirato non impostato

--output (stringa)

Scegliere un formato di output, che può essere 'json' o 'tabella'. (predefinito "tabella")

-q, --quiet (bool)

Elimina i messaggi dettagliati.

ibmcloud project select --unset-project

Opzioni comando

--definition (ProjectPrototypeDefinition)

La definizione del progetto. Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition=@path/to/file.json.

--location (stringa)

L'ubicazione IBM Cloud in cui è distribuita una risorsa. Obbligatorio.

I valori consentiti sono: us-south, us-east, eu-gb, eu-de, ca-tor.

--resource-group (stringa)

Il nome del gruppo di risorse in cui vengono creati i dati e gli strumenti del progetto. Obbligatorio.

La lunghezza massima è di 64 caratteri. La lunghezza minima è di 0 caratteri. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)[^'"`<>{}\\x00-\\x1F]*$/.

--configs (ProjectConfigPrototype[])

Le configurazioni di progetto. Queste configurazioni sono incluse nella risposta di creazione di un progetto solo se un array di configurazione è specificato nel payload della richiesta.

Il valore predefinito è []. La lunghezza massima è di 100 articoli. La lunghezza minima è 0 articoli.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --configs=@path/to/file.json.

--environments (EnvironmentPrototype[])

L'ambiente del progetto. Questi ambienti sono inclusi nella risposta di creazione di un progetto solo se un array di ambiente è specificato nel payload della richiesta.

Il valore predefinito è []. La lunghezza massima è di 20 articoli. La lunghezza minima è 0 articoli.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --environments=@path/to/file.json.

--definition-name (stringa)

Il nome del progetto. È univoco all'interno dell'account in tutte le regioni. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 128 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)[^'"`\/<>{}\\x00-\\x1F]+$/.

--definition-description (stringa)

Una breve spiegazione dell'utilizzo del progetto nella configurazione di un'architettura distribuibile. È possibile creare un progetto senza fornire una descrizione. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Il valore predefinito è . La lunghezza massima è 1024 caratteri. La lunghezza minima è di 0 caratteri. Il valore deve corrispondere all'espressione regolare /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/.

--definition-auto-deploy-mode (stringa)

Si tratta di un'impostazione avanzata dell'Auto deploy, che indica il comportamento dell'Auto deploy quando è abilitato. Esistono 2 opzioni:

1. auto_approval approverà automaticamente la configurazione dopo averla convalidata senza la conferma dell'utente.
2. manual_approval richiederà la conferma dell'utente per approvare la configurazione dopo la convalida prima di avviare la distribuzione della configurazione. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Il valore predefinito è manual_approval. I valori ammessi sono: auto_approval, manual_approval.

--definition-monitoring-enabled (bool)

Un indicatore booleano per abilitare il rilevamento automatico della deviazione. Usare questo campo per eseguire un controllo giornaliero per confrontare le configurazioni con le risorse distribuite e rilevare eventuali differenze. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Il valore predefinito è false.

--definition-destroy-on-delete (bool)

La politica che indica se la distribuzione delle risorse è stata annullata o meno quando un progetto è stato eliminato. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Il valore predefinito è true.

--definition-store (ProjectDefinitionStore)

I dettagli necessari per memorizzare in modo personalizzato le configurazioni del progetto. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-store=@path/to/file.json.

--definition-terraform-engine (ProjectTerraformEngineSettings)

Schema sperimentale: serve per la prototipazione. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-terraform-engine=@path/to/file.json.

--definition-auto-deploy (bool)

Un flag booleano per abilitare la distribuzione automatica delle configurazioni. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Il valore predefinito è false.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempi

ibmcloud project create \
    --definition '{"name": "acme-microservice", "description": "A microservice to deploy on top of ACME infrastructure.", "auto_deploy_mode": "manual_approval", "monitoring_enabled": false, "destroy_on_delete": true, "store": {"type": "gh", "url": "exampleString", "token": "exampleString", "config_directory": "exampleString"}, "terraform_engine": {"id": "exampleString", "type": "terraform-enterprise"}, "auto_deploy": false}' \
    --location us-south \
    --resource-group Default \
    --configs '[{"definition": {"compliance_profile": {}, "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global", "members": [{"name": "exampleString", "config_id": "exampleString"}], "description": "The stage account configuration.", "name": "account-stage", "authorizations": {"trusted_profile_id": "exampleString", "method": "exampleString", "api_key": "exampleString"}, "inputs": {"anyKey": "anyValue"}, "settings": {"anyKey": "anyValue"}, "environment_id": "exampleString"}, "schematics": {"workspace_crn": "crn:v1:staging:public:project:us-south:a/4e1c48fcf8ac33c0a2441e4139f189ae:bf40ad13-b107-446a-8286-c6d576183bb1::"}}]' \
    --environments '[{"definition": {"description": "exampleString", "name": "exampleString", "authorizations": {"trusted_profile_id": "exampleString", "method": "exampleString", "api_key": "exampleString"}, "inputs": {"anyKey": "anyValue"}, "compliance_profile": {}}}]'

In alternativa, sono disponibili opzioni granulari per i sottocampi delle opzioni della stringa JSON:

ibmcloud project create \
    --location us-south \
    --resource-group Default \
    --configs '[projectConfigPrototype]' \
    --environments '[environmentPrototype]' \
    --definition-name exampleString \
    --definition-description exampleString \
    --definition-auto-deploy-mode manual_approval \
    --definition-monitoring-enabled=false \
    --definition-destroy-on-delete=true \
    --definition-store projectDefinitionStore \
    --definition-terraform-engine projectTerraformEngineSettings \
    --definition-auto-deploy=false

Opzioni comando

--token (stringa)

Il server utilizza questo parametro per determinare la prima voce restituita nella pagina successiva. Se questo parametro non viene specificato, viene restituita la prima pagina logica.

Il valore predefinito è . La lunghezza massima è 1536 caratteri. La lunghezza minima è di 0 caratteri. Il valore deve corrispondere all'espressione regolare /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/.

--limit (int64)

Il numero massimo di risorse da restituire. Il numero di risorse restituite è lo stesso, tranne che per l'ultima pagina.

Il valore predefinito è 10. Il valore massimo è 100. Il valore minimo è 1.

--all-pages (bool)

Invoca più richieste per visualizzare tutte le pagine dell'insieme per l'elenco.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project list \
    --token exampleString \
    --limit 10

Output di esempio

Una richiesta di esempio per elencare i progetti.

{
  "limit" : 10,
  "first" : {
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
  },
  "next" : {
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/12349050-1234-ac97-0000-ba5a12fe9087"
  },
  "projects" : [ {
    "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
    "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "href" : "https://projects.service.url/v1/projects/cfbf901-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "description" : "A project example.",
      "name" : "iaas-infra-prestage-env",
      "destroy_on_delete" : false
    },
    "location" : "us-south",
    "state" : "ready",
    "resource_group" : "Default",
    "resource_group_id" : "f37d2637ea814cfd9a1742683a713d24",
    "cumulative_needs_attention_view" : [ {
      "event" : "project.instance.update"
    }, {
      "event_id" : "489f0090-6d7c-4af5-8f20-9106543e4974"
    }, {
      "config_id" : "069ab83e-5016-4bf2-bd50-cc95cf678293"
    }, {
      "config_version" : 1
    } ]
  }, {
    "id" : "1123ed42-4356-efa1-1101-235900fe9087",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "href" : "https://projects.service.url/v1/projects/cfbf901-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "description" : "A project example.",
      "name" : "iaas-infra-stage-env",
      "destroy_on_delete" : false
    },
    "crn" : "crn:v1:staging:public:project:eu-de:a/06580d923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
    "location" : "eu-gb",
    "state" : "ready",
    "resource_group" : "Default",
    "resource_group_id" : "f37d2637ea814cfd9a1742683a713d24",
    "cumulative_needs_attention_view" : [ ]
  } ]
}

Percorso JMES predefinito

Per impostazione predefinita, all'output di questo comando viene applicata una query JMESPath, se non viene fornita dall'utente. La query esatta dipende dallo scenario e dal formato di output richiesto. La condizione per ogni query JMESPath predefinita è riportata nella tabella seguente:

Se viene fornita una query JMESPath personalizzata, questa sostituirà qualsiasi JMESPath della tabella precedente.

Opzioni comando

--id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

Esempio

ibmcloud project get \
    --id exampleString

Output di esempio

Una risposta di esempio per richiamare un progetto con configurazioni.

{
  "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
  "created_at" : "2023-02-22T19:51:23.253Z",
  "modified_at" : "2023-02-22T19:51:23.253Z",
  "href" : "https://projects.service.url/v1/projects/cfbf901-ab8e-ac97-b01b-ab5af830be8a",
  "definition" : {
    "name" : "acme-microservice",
    "description" : "A microservice to deploy on top of ACME infrastructure.",
    "auto_deploy_mode" : "manual_approval",
    "auto_deploy" : false,
    "destroy_on_delete" : true,
    "monitoring_enabled" : false
  },
  "configs" : [ {
    "id" : "673d79e4-52bf-4184-b8e9-d3ca3c110f96",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "deployment_model" : "project_deployed",
    "definition" : {
      "name" : "common-variables",
      "description" : "The common-variables configuration."
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/673d79e4-52bf-4184-b8e9-d3ca3c110f96",
    "is_draft" : true,
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "state" : "draft",
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "update_available" : false,
    "version" : 1
  }, {
    "id" : "4a1d4ba2-54ba-43a7-975a-d82b5a7612d1",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "deployment_model" : "project_deployed",
    "definition" : {
      "name" : "account-stage",
      "description" : "The stage account configuration. The stage account hosts test environments prestage, performance, stage. This configuration configures services that are common to all these environments and regions. It's a `terraform_template` type of configuration that points to a GitHub repository that hosts the terraform modules that a Schematics workspace can deploy."
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/4a1d4ba2-54ba-43a7-975a-d82b5a7612d1",
    "is_draft" : true,
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "state" : "draft",
    "update_available" : false,
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "version" : 1
  }, {
    "id" : "293c3c36-a094-4115-a12b-de0a9ca39be5",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "deployment_model" : "project_deployed",
    "definition" : {
      "name" : "env-stage",
      "description" : "The stage environment configuration. It includes services that are common to all the environment regions. A blueprint must be used to configure all the services that are common to the stage regions. It's a `terraform_template` type of configuration that points to a GitHub repository that hosts the Terraform modules that a Schematics workspace can deploy."
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/293c3c36-a094-4115-a12b-de0a9ca39be5",
    "is_draft" : true,
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "state" : "draft",
    "update_available" : false,
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "version" : 1
  }, {
    "id" : "596e8656-9d4b-41a5-8340-b0cbe8bd374a",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "deployment_model" : "project_deployed",
    "definition" : {
      "name" : "region-us-south-stage",
      "description" : "The stage `us-south` configuration. A blueprint must be used to configure the Virtual Private Cloud and Red Hat OpenShift stage `us-south`."
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/596e8656-9d4b-41a5-8340-b0cbe8bd374a",
    "is_draft" : true,
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "state" : "draft",
    "update_available" : false,
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "version" : 1
  }, {
    "id" : "9c7afed6-17fb-4c56-a13d-440a78f936bd",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "deployment_model" : "project_deployed",
    "definition" : {
      "name" : "region-eu-de-stage",
      "description" : "The stage `eu-de` configuration. A blueprint must be used to configure the Virtual Private Cloud and Red Hat OpenShift stage `eu-de`."
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/9c7afed6-17fb-4c56-a13d-440a78f936bd",
    "is_draft" : true,
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "state" : "draft",
    "update_available" : false,
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "version" : 1
  } ],
  "environments" : [ {
    "id" : "b0c44146-1ef6-40c2-82ba-74d51149770a",
    "definition" : {
      "name" : "dev-environment",
      "description" : "The development environment."
    },
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "created_at" : "2023-02-10T10:05:35.787Z",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/environments/b0c44146-1ef6-40c2-82ba-74d51149770a"
  } ],
  "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
  "cumulative_needs_attention_view" : [ {
    "event" : "project.instance.update"
  }, {
    "event_id" : "489f0090-6d7c-4af5-8f20-9106543e4974"
  }, {
    "config_id" : "069ab83e-5016-4bf2-bd50-cc95cf678293"
  }, {
    "config_version" : 1
  } ],
  "event_notifications_crn" : "crn:v1:staging:public:event-notifications:us-south:a/06580c923e40314421d3b6cb40c01c68:instance-id::",
  "location" : "us-south",
  "resource_group" : "Default",
  "resource_group_id" : "f37d2637ea814cfd9a1742683a713d24",
  "state" : "ready"
}

Percorso JMES predefinito

Per impostazione predefinita, all'output di questo comando viene applicata una query JMESPath, se non viene fornita dall'utente. La query esatta dipende dallo scenario e dal formato di output richiesto. La condizione per ogni query JMESPath predefinita è riportata nella tabella seguente:

Se viene fornita una query JMESPath personalizzata, questa sostituirà qualsiasi JMESPath della tabella precedente.

Opzioni comando

--id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--definition (ProjectDefinitionPatch)

La definizione del progetto. Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition=@path/to/file.json.

--definition-name (stringa)

Il nome del progetto. È univoco all'interno dell'account in tutte le regioni. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 128 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)[^'"`\/<>{}\\x00-\\x1F]+$/.

--definition-description (stringa)

Una breve spiegazione dell'utilizzo del progetto nella configurazione di un'architettura distribuibile. È possibile creare un progetto senza fornire una descrizione. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 1024 caratteri. La lunghezza minima è di 0 caratteri. Il valore deve corrispondere all'espressione regolare /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/.

--definition-auto-deploy-mode (stringa)

Si tratta di un'impostazione avanzata dell'Auto deploy, che indica il comportamento dell'Auto deploy quando è abilitato. Esistono 2 opzioni:

1. auto_approval approverà automaticamente la configurazione dopo averla convalidata senza la conferma dell'utente.
2. manual_approval richiederà la conferma dell'utente per approvare la configurazione dopo la convalida prima di avviare la distribuzione della configurazione. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

I valori ammessi sono: auto_approval, manual_approval.

--definition-monitoring-enabled (bool)

Un indicatore booleano per abilitare il rilevamento automatico della deviazione. Usare questo campo per eseguire un controllo giornaliero per confrontare le configurazioni con le risorse distribuite e rilevare eventuali differenze. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

--definition-destroy-on-delete (bool)

La politica che indica se la distribuzione delle risorse è stata annullata o meno quando un progetto è stato eliminato. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

--definition-store (ProjectDefinitionStore)

I dettagli necessari per memorizzare in modo personalizzato le configurazioni del progetto. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-store=@path/to/file.json.

--definition-terraform-engine (ProjectTerraformEngineSettings)

Schema sperimentale: serve per la prototipazione. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-terraform-engine=@path/to/file.json.

--definition-auto-deploy (bool)

Un flag booleano per abilitare la distribuzione automatica delle configurazioni. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempi

ibmcloud project update \
    --id exampleString \
    --definition '{"name": "acme-microservice", "description": "A microservice to deploy on top of ACME infrastructure.", "auto_deploy_mode": "auto_approval", "monitoring_enabled": true, "destroy_on_delete": true, "store": {"type": "gh", "url": "exampleString", "token": "exampleString", "config_directory": "exampleString"}, "terraform_engine": {"id": "exampleString", "type": "terraform-enterprise"}, "auto_deploy": true}'

In alternativa, sono disponibili opzioni granulari per i sottocampi delle opzioni della stringa JSON:

ibmcloud project update \
    --id exampleString \
    --definition-name exampleString \
    --definition-description exampleString \
    --definition-auto-deploy-mode auto_approval \
    --definition-monitoring-enabled=true \
    --definition-destroy-on-delete=true \
    --definition-store projectDefinitionStore \
    --definition-terraform-engine projectTerraformEngineSettings \
    --definition-auto-deploy=true

Output di esempio

Una risposta di esempio per richiamare un progetto con configurazioni.

{
  "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
  "created_at" : "2023-02-22T19:51:23.253Z",
  "modified_at" : "2023-02-22T19:51:23.253Z",
  "href" : "https://projects.service.url/v1/projects/cfbf901-ab8e-ac97-b01b-ab5af830be8a",
  "definition" : {
    "name" : "acme-microservice",
    "description" : "A microservice to deploy on top of ACME infrastructure.",
    "auto_deploy_mode" : "manual_approval",
    "auto_deploy" : false,
    "destroy_on_delete" : true,
    "monitoring_enabled" : false
  },
  "configs" : [ {
    "id" : "673d79e4-52bf-4184-b8e9-d3ca3c110f96",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "deployment_model" : "project_deployed",
    "definition" : {
      "name" : "common-variables",
      "description" : "The common-variables configuration."
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/673d79e4-52bf-4184-b8e9-d3ca3c110f96",
    "is_draft" : true,
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "state" : "draft",
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "update_available" : false,
    "version" : 1
  }, {
    "id" : "4a1d4ba2-54ba-43a7-975a-d82b5a7612d1",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "deployment_model" : "project_deployed",
    "definition" : {
      "name" : "account-stage",
      "description" : "The stage account configuration. The stage account hosts test environments prestage, performance, stage. This configuration configures services that are common to all these environments and regions. It's a `terraform_template` type of configuration that points to a GitHub repository that hosts the terraform modules that a Schematics workspace can deploy."
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/4a1d4ba2-54ba-43a7-975a-d82b5a7612d1",
    "is_draft" : true,
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "state" : "draft",
    "update_available" : false,
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "version" : 1
  }, {
    "id" : "293c3c36-a094-4115-a12b-de0a9ca39be5",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "deployment_model" : "project_deployed",
    "definition" : {
      "name" : "env-stage",
      "description" : "The stage environment configuration. It includes services that are common to all the environment regions. A blueprint must be used to configure all the services that are common to the stage regions. It's a `terraform_template` type of configuration that points to a GitHub repository that hosts the Terraform modules that a Schematics workspace can deploy."
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/293c3c36-a094-4115-a12b-de0a9ca39be5",
    "is_draft" : true,
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "state" : "draft",
    "update_available" : false,
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "version" : 1
  }, {
    "id" : "596e8656-9d4b-41a5-8340-b0cbe8bd374a",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "deployment_model" : "project_deployed",
    "definition" : {
      "name" : "region-us-south-stage",
      "description" : "The stage `us-south` configuration. A blueprint must be used to configure the Virtual Private Cloud and Red Hat OpenShift stage `us-south`."
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/596e8656-9d4b-41a5-8340-b0cbe8bd374a",
    "is_draft" : true,
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "state" : "draft",
    "update_available" : false,
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "version" : 1
  }, {
    "id" : "9c7afed6-17fb-4c56-a13d-440a78f936bd",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "deployment_model" : "project_deployed",
    "definition" : {
      "name" : "region-eu-de-stage",
      "description" : "The stage `eu-de` configuration. A blueprint must be used to configure the Virtual Private Cloud and Red Hat OpenShift stage `eu-de`."
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/9c7afed6-17fb-4c56-a13d-440a78f936bd",
    "is_draft" : true,
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "state" : "draft",
    "update_available" : false,
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "version" : 1
  } ],
  "environments" : [ {
    "id" : "b0c44146-1ef6-40c2-82ba-74d51149770a",
    "definition" : {
      "name" : "dev-environment",
      "description" : "The development environment."
    },
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "created_at" : "2023-02-10T10:05:35.787Z",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/environments/b0c44146-1ef6-40c2-82ba-74d51149770a"
  } ],
  "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
  "cumulative_needs_attention_view" : [ {
    "event" : "project.instance.update"
  }, {
    "event_id" : "489f0090-6d7c-4af5-8f20-9106543e4974"
  }, {
    "config_id" : "069ab83e-5016-4bf2-bd50-cc95cf678293"
  }, {
    "config_version" : 1
  } ],
  "event_notifications_crn" : "crn:v1:staging:public:event-notifications:us-south:a/06580c923e40314421d3b6cb40c01c68:instance-id::",
  "location" : "us-south",
  "resource_group" : "Default",
  "resource_group_id" : "f37d2637ea814cfd9a1742683a713d24",
  "state" : "ready"
}

Opzioni comando

--id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

Esempio

ibmcloud project delete \
    --id exampleString

Output di esempio

La risposta di esempio a una richiesta di eliminare un progetto.

{
  "id" : "4059955c-ccb3-4fd3-aa48-34e3b8334f80"
}

Opzioni comando

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--definition (EnvironmentDefinitionRequiredProperties)

La definizione dell'ambiente. Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition=@path/to/file.json.

--definition-description (stringa)

La descrizione dell'ambiente. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Il valore predefinito è . La lunghezza massima è 1024 caratteri. La lunghezza minima è di 0 caratteri. Il valore deve corrispondere all'espressione regolare /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/.

--definition-name (stringa)

Il nome dell'ambiente. È unico all'interno dell'account tra progetti e regioni. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 128 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)[^'"`<>{}\\x00-\\x1F]+$/.

--definition-authorizations (ProjectConfigAuth)

I dettagli dell'autorizzazione. Puoi autorizzare utilizzando un profilo attendibile o una chiave API in Secrets Manager. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-authorizations=@path/to/file.json.

--definition-inputs (mappa generica)

Le variabili di input utilizzate per la definizione di configurazione e l'ambiente. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-inputs=@path/to/file.json.

--definition-compliance-profile (ProjectComplianceProfile)

Il profilo richiesto per la conformità. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-compliance-profile=@path/to/file.json.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempi

ibmcloud project environment-create \
    --project-id exampleString \
    --definition '{"description": "The environment development.", "name": "development", "authorizations": {"trusted_profile_id": "Profile-9ac10c5c-195c-41ef-b465-68a6b6dg5f12", "method": "trusted_profile", "api_key": "exampleString"}, "inputs": {"anyKey": "anyValue"}, "compliance_profile": {"id": "some-profile-id", "instance_id": "some-instance-id", "instance_location": "us-south", "attachment_id": "some-attachment-id", "profile_name": "some-profile-name", "wp_policy_id": "exampleString", "wp_instance_id": "exampleString", "wp_instance_name": "exampleString", "wp_instance_location": "us-south", "wp_zone_id": "exampleString", "wp_zone_name": "exampleString", "wp_policy_name": "exampleString"}}'

In alternativa, sono disponibili opzioni granulari per i sottocampi delle opzioni della stringa JSON:

ibmcloud project environment-create \
    --project-id exampleString \
    --definition-description exampleString \
    --definition-name exampleString \
    --definition-authorizations projectConfigAuth \
    --definition-inputs '{"anyKey": "anyValue"}' \
    --definition-compliance-profile projectComplianceProfile

Output di esempio

La risposta dell'ambiente di esempio.

{
  "id" : "env123",
  "definition" : {
    "name" : "development",
    "description" : "The environment development.",
    "authorizations" : {
      "method" : "trusted_profile",
      "trusted_profile_id" : "Profile-9ac10c5c-195c-41ef-b465-68a6b6dg5f12"
    },
    "inputs" : {
      "resource_group" : "stage",
      "region" : "us-south"
    },
    "compliance_profile" : {
      "id" : "some-profile-id",
      "instance_id" : "some-instance-id",
      "instance_location" : "us-south",
      "profile_name" : "some-profile-name",
      "attachment_id" : "some-attachment-id"
    }
  },
  "project" : {
    "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "name" : "iaas-infra-prestage-env"
    },
    "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
  },
  "created_at" : "2023-06-29T03:28:14.709Z",
  "modified_at" : "2023-06-29T03:28:14.709Z",
  "href" : "https://projects.api.cloud.ibm.com/v1/projects/6fd53106-7ce6-429e-8c57-f22e832d0c4b/environments/2102afed-94c7-46fe-90f2-7fff290637b4"
}

Opzioni comando

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--token (stringa)

Il server utilizza questo parametro per determinare la prima voce restituita nella pagina successiva. Se questo parametro non viene specificato, viene restituita la prima pagina logica.

Il valore predefinito è . La lunghezza massima è 1536 caratteri. La lunghezza minima è di 0 caratteri. Il valore deve corrispondere all'espressione regolare /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/.

--limit (int64)

Il numero massimo di risorse da restituire. Il numero di risorse restituite è lo stesso, tranne che per l'ultima pagina.

Il valore predefinito è 10. Il valore massimo è 100. Il valore minimo è 1.

--all-pages (bool)

Invocare più richieste per visualizzare tutte le pagine della raccolta per ambienti.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project environments \
    --project-id exampleString \
    --token exampleString \
    --limit 10

Output di esempio

La risposta dell'ambiente di esempio per un elenco.

{
  "limit" : 1,
  "first" : {
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/environments?limit=1"
  },
  "next" : {
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/environments?limit=1&token=da969bff-vf9q-3t1t-b677-d6rt5c0de54e"
  },
  "environments" : [ {
    "id" : "env123",
    "definition" : {
      "name" : "development",
      "description" : "The environment development.",
      "authorizations" : {
        "method" : "trusted_profile",
        "trusted_profile_id" : "Profile-9ac10c5c-195c-41ef-b465-68a6b6dg5f12"
      },
      "inputs" : {
        "resource_group" : "stage",
        "region" : "us-south"
      },
      "compliance_profile" : {
        "id" : "some-profile-id",
        "instance_id" : "some-instance-id",
        "instance_location" : "us-south",
        "profile_name" : "some-profile-name",
        "attachment_id" : "some-attachment-id"
      }
    },
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "created_at" : "2023-06-29T03:28:14.709Z",
    "modified_at" : "2023-06-29T03:28:14.709Z",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/6fd53106-7ce6-429e-8c57-f22e832d0c4b/environments/2102afed-94c7-46fe-90f2-7fff290637b4"
  } ]
}

Opzioni comando

--id (stringa)

L'ID ambiente. Obbligatorio.

La lunghezza massima è di 256 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$).+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project environment \
    --project-id exampleString \
    --id exampleString

Output di esempio

La risposta dell'ambiente di esempio.

{
  "id" : "env123",
  "definition" : {
    "name" : "development",
    "description" : "The environment development.",
    "authorizations" : {
      "method" : "trusted_profile",
      "trusted_profile_id" : "Profile-9ac10c5c-195c-41ef-b465-68a6b6dg5f12"
    },
    "inputs" : {
      "resource_group" : "stage",
      "region" : "us-south"
    },
    "compliance_profile" : {
      "id" : "some-profile-id",
      "instance_id" : "some-instance-id",
      "instance_location" : "us-south",
      "profile_name" : "some-profile-name",
      "attachment_id" : "some-attachment-id"
    }
  },
  "project" : {
    "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "name" : "iaas-infra-prestage-env"
    },
    "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
  },
  "created_at" : "2023-06-29T03:28:14.709Z",
  "modified_at" : "2023-06-29T03:28:14.709Z",
  "href" : "https://projects.api.cloud.ibm.com/v1/projects/6fd53106-7ce6-429e-8c57-f22e832d0c4b/environments/2102afed-94c7-46fe-90f2-7fff290637b4"
}

Opzioni comando

--id (stringa)

L'ID ambiente. Obbligatorio.

La lunghezza massima è di 256 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$).+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--definition (EnvironmentDefinitionPropertiesPatch)

La definizione di ambiente utilizzata per aggiornamenti. Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition=@path/to/file.json.

--definition-description (stringa)

La descrizione dell'ambiente. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 1024 caratteri. La lunghezza minima è di 0 caratteri. Il valore deve corrispondere all'espressione regolare /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/.

--definition-name (stringa)

Il nome dell'ambiente. È unico all'interno dell'account tra progetti e regioni. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 128 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)[^'"`<>{}\\x00-\\x1F]+$/.

--definition-authorizations (ProjectConfigAuth)

I dettagli dell'autorizzazione. Puoi autorizzare utilizzando un profilo attendibile o una chiave API in Secrets Manager. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-authorizations=@path/to/file.json.

--definition-inputs (mappa generica)

Le variabili di input utilizzate per la definizione di configurazione e l'ambiente. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-inputs=@path/to/file.json.

--definition-compliance-profile (ProjectComplianceProfile)

Il profilo richiesto per la conformità. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-compliance-profile=@path/to/file.json.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempi

ibmcloud project environment-update \
    --project-id exampleString \
    --id exampleString \
    --definition '{"description": "The environment development.", "name": "development", "authorizations": {"trusted_profile_id": "Profile-9ac10c5c-195c-41ef-b465-68a6b6dg5f12", "method": "trusted_profile", "api_key": "exampleString"}, "inputs": {"anyKey": "anyValue"}, "compliance_profile": {"id": "some-profile-id", "instance_id": "some-instance-id", "instance_location": "us-south", "attachment_id": "some-attachment-id", "profile_name": "some-profile-name", "wp_policy_id": "exampleString", "wp_instance_id": "exampleString", "wp_instance_name": "exampleString", "wp_instance_location": "us-south", "wp_zone_id": "exampleString", "wp_zone_name": "exampleString", "wp_policy_name": "exampleString"}}'

In alternativa, sono disponibili opzioni granulari per i sottocampi delle opzioni della stringa JSON:

ibmcloud project environment-update \
    --project-id exampleString \
    --id exampleString \
    --definition-description exampleString \
    --definition-name exampleString \
    --definition-authorizations projectConfigAuth \
    --definition-inputs '{"anyKey": "anyValue"}' \
    --definition-compliance-profile projectComplianceProfile

Output di esempio

La risposta dell'ambiente di esempio.

{
  "id" : "env123",
  "definition" : {
    "name" : "development",
    "description" : "The environment development.",
    "authorizations" : {
      "method" : "trusted_profile",
      "trusted_profile_id" : "Profile-9ac10c5c-195c-41ef-b465-68a6b6dg5f12"
    },
    "inputs" : {
      "resource_group" : "stage",
      "region" : "us-south"
    },
    "compliance_profile" : {
      "id" : "some-profile-id",
      "instance_id" : "some-instance-id",
      "instance_location" : "us-south",
      "profile_name" : "some-profile-name",
      "attachment_id" : "some-attachment-id"
    }
  },
  "project" : {
    "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "name" : "iaas-infra-prestage-env"
    },
    "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
  },
  "created_at" : "2023-06-29T03:28:14.709Z",
  "modified_at" : "2023-06-29T03:28:14.709Z",
  "href" : "https://projects.api.cloud.ibm.com/v1/projects/6fd53106-7ce6-429e-8c57-f22e832d0c4b/environments/2102afed-94c7-46fe-90f2-7fff290637b4"
}

Opzioni comando

--id (stringa)

L'ID ambiente. Obbligatorio.

La lunghezza massima è di 256 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$).+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project environment-delete \
    --project-id exampleString \
    --id exampleString

Output di esempio

La risposta di esempio per la cancellazione dell'ambiente.

{
  "id" : "env123"
}

Opzioni comando

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--definition (ProjectConfigDefinitionPrototype)

Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition=@path/to/file.json.

--schematics (SchematicsWorkspace)

Uno spazio di lavoro Schematics da utilizzare per la distribuzione di questa architettura distribuibile.

Se si importano i dati da un'area di lavoro esistente di Schematics che non è supportata da un carrello, è necessario fornire un'area locator_id. Se si utilizza un'area di lavoro Schematics supportata da un carrello, non è necessario un locator_id perché l'area di lavoro Schematics ne ha uno.

Ci sono 3 scenari:

1. Se viene specificato solo un locator_id, viene istanziata una nuova area di lavoro Schematics con tale locator_id.
2. Se viene specificato solo uno schema workspace_crn, viene restituito un 400 se non viene trovato un locator_id nello spazio di lavoro schematics esistente.
3. Se vengono specificati sia un Schematics workspace_crn che un locator_id, viene restituito un codice 400 se il locator_id specificato non concorda con il locator_id nell'area di lavoro Schematics esistente.

Per ulteriori informazioni, vedere Creazione di spazi di lavoro e importazione del modello Terraform. Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --schematics=@path/to/file.json.

--definition-compliance-profile (ProjectComplianceProfile)

Il profilo richiesto per la conformità. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-compliance-profile=@path/to/file.json.

--definition-locator-id (stringa)

Una concatenazione univoca dell'ID catalogo e dell'ID versione che identifica l'architettura distribuibile nel catalogo. Se si importa da un'area di lavoro Schematics esistente che non è supportata dal carrello, è necessario un locator_id. Se si utilizza un'area di lavoro Schematics supportata da un carrello, non è necessario un locator_id perché l'area di lavoro Schematics ne possiede uno.

Ci sono 3 scenari:

1. Se viene specificato solo un locator_id, viene istanziata una nuova area di lavoro Schematics con tale locator_id.
2. Se viene specificato solo uno schema workspace_crn, viene restituito un 400 se non viene trovato un locator_id nello spazio di lavoro schematics esistente.
3. Se vengono specificati sia Schematics workspace_crn che locator_id, viene restituito un messaggio 400 se il locator_id specificato non è in accordo con locator_id nello spazio di lavoro Schematics esistente. Per ulteriori informazioni sulla creazione di uno spazio di lavoro Schematics, vedere Creazione di spazi di lavoro e importazione del modello Terraform. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 512 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)[\\.0-9a-z-A-Z_-]+$/.

--definition-members (StackMember[])

Le architetture distribuibili membro che sono incluse nello stack. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 100 articoli. La lunghezza minima è 0 articoli.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-members=@path/to/file.json.

--definition-uses (ProjectConfigUses[])

Le architetture deployabe dipendenti a cui fa riferimento questa configurazione. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 100 articoli. La lunghezza minima è 0 articoli.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-uses=@path/to/file.json.

--definition-description (stringa)

Una descrizione di configurazione del progetto. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Il valore predefinito è . La lunghezza massima è 1024 caratteri. La lunghezza minima è di 0 caratteri. Il valore deve corrispondere all'espressione regolare /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/.

--definition-name (stringa)

Il nome della configurazione. È unico all'interno dell'account tra progetti e regioni. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 128 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^[a-zA-Z0-9][a-zA-Z0-9-_ ]*$/.

--definition-authorizations (ProjectConfigAuth)

I dettagli dell'autorizzazione. Può autorizzare utilizzando un profilo di fiducia o una chiave API in Secrets Manager. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-authorizations=@path/to/file.json.

--definition-inputs (mappa generica)

Le variabili di input utilizzate per la definizione di configurazione e l'ambiente. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-inputs=@path/to/file.json.

--definition-settings (mappa generica)

Le variabili di ambiente Schematics da utilizzare per distribuire la configurazione. Le impostazioni sono disponibili solo se vengono specificate quando la configurazione viene inizialmente creata. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-settings=@path/to/file.json.

--definition-environment-id (stringa)

L'ID dell'ambiente del progetto. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--definition-resource-crns (stringa[])

I CRN delle risorse associate a questa configurazione. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Gli elementi dell'elenco devono corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)(crn)[^'"`<>{}\\s\\x00-\\x1F]*$/. La lunghezza massima è di 110 articoli. La lunghezza minima è 0 articoli.

--schematics-workspace-crn (stringa)

Un nome di risorsa IBM Cloud che identifica in modo univoco una risorsa. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'schematics'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 512 caratteri. La lunghezza minima è di 4 caratteri. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)(crn)[^'"`<>{}\\s\\x00-\\x1F]*$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempi

ibmcloud project config-create \
    --project-id exampleString \
    --definition '{"compliance_profile": {}, "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global", "members": [{"name": "exampleString", "config_id": "exampleString"}], "description": "The stage environment configuration.", "name": "env-stage", "authorizations": {"trusted_profile_id": "exampleString", "method": "exampleString", "api_key": "exampleString"}, "inputs": {"anyKey": "anyValue"}, "settings": {"anyKey": "anyValue"}, "environment_id": "exampleString"}' \
    --schematics '{"workspace_crn": "crn:v1:staging:public:project:us-south:a/4e1c48fcf8ac33c0a2441e4139f189ae:bf40ad13-b107-446a-8286-c6d576183bb1::"}'

In alternativa, sono disponibili opzioni granulari per i sottocampi delle opzioni della stringa JSON:

ibmcloud project config-create \
    --project-id exampleString \
    --definition-compliance-profile projectComplianceProfile \
    --definition-locator-id exampleString \
    --definition-members '[stackMember]' \
    --definition-uses '[projectConfigUses]' \
    --definition-description exampleString \
    --definition-name exampleString \
    --definition-authorizations projectConfigAuth \
    --definition-inputs '{"anyKey": "anyValue"}' \
    --definition-settings '{"anyKey": "anyValue"}' \
    --definition-environment-id exampleString \
    --schematics-workspace-crn crn:v1:staging:public:project:us-south:a/4e1c48fcf8ac33c0a2441e4139f189ae:bf40ad13-b107-446a-8286-c6d576183bb1::

Opzioni comando

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--token (stringa)

Il server utilizza questo parametro per determinare la prima voce restituita nella pagina successiva. Se questo parametro non viene specificato, viene restituita la prima pagina logica.

Il valore predefinito è . La lunghezza massima è 1536 caratteri. La lunghezza minima è di 0 caratteri. Il valore deve corrispondere all'espressione regolare /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/.

--limit (int64)

Il numero massimo di risorse da restituire. Il numero di risorse restituite è lo stesso, tranne che per l'ultima pagina.

Il valore predefinito è 10. Il valore massimo è 100. Il valore minimo è 1.

--all-pages (bool)

Invoca più richieste per visualizzare tutte le pagine della raccolta per le configurazioni.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project configs \
    --project-id exampleString \
    --token exampleString \
    --limit 10

Output di esempio

La risposta di esempio per una richiesta di acquisizione delle configurazioni di progetto.

{
  "limit" : 2,
  "first" : {
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs?limit=2"
  },
  "next" : {
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs?limit=2&token=da969bff-vf9q-3t1t-b677-d6rt5c0de54e"
  },
  "configs" : [ {
    "id" : "293c3c36-a094-4115-a12b-de0a9ca39be5",
    "deployment_model" : "project_deployed",
    "definition" : {
      "name" : "env-stage",
      "description" : "The stage environment configuration."
    },
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "version" : 1,
    "state" : "validated",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/db268db0-160b-4911-8f93-89659000a927/configs/293c3c36-a094-4115-a12b-de0a9ca39be5"
  }, {
    "id" : "9c7afed6-17fb-4c56-a13d-440a78f936bd",
    "deployment_model" : "project_deployed",
    "definition" : {
      "name" : "region-eu-de-stage",
      "description" : "The stage `eu-de` configuration."
    },
    "approved_version" : {
      "definition" : {
        "locator_id" : "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global"
      },
      "version" : 1,
      "state" : "approved",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/db268db0-160b-4911-8f93-89659000a927/configs/9c7afed6-17fb-4c56-a13d-440a78f936bd/versions/1"
    },
    "project" : {
      "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
      "definition" : {
        "name" : "iaas-infra-prestage-env"
      },
      "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
      "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
    },
    "version" : 2,
    "state" : "draft",
    "created_at" : "2023-02-22T19:51:23.253Z",
    "modified_at" : "2023-02-22T19:51:23.253Z",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/db268db0-160b-4911-8f93-89659000a927/configs/9c7afed6-17fb-4c56-a13d-440a78f936bd"
  } ]
}

Percorso JMES predefinito

Per impostazione predefinita, all'output di questo comando viene applicata una query JMESPath, se non viene fornita dall'utente. La query esatta dipende dallo scenario e dal formato di output richiesto. La condizione per ogni query JMESPath predefinita è riportata nella tabella seguente:

Se viene fornita una query JMESPath personalizzata, questa sostituirà qualsiasi JMESPath della tabella precedente.

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

Esempio

ibmcloud project config \
    --project-id exampleString \
    --id exampleString

Percorso JMES predefinito

Per impostazione predefinita, all'output di questo comando viene applicata una query JMESPath, se non viene fornita dall'utente. La query esatta dipende dallo scenario e dal formato di output richiesto. La condizione per ogni query JMESPath predefinita è riportata nella tabella seguente:

Se viene fornita una query JMESPath personalizzata, questa sostituirà qualsiasi JMESPath della tabella precedente.

Opzioni comando

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--definition (ProjectConfigDefinitionPatch)

Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition=@path/to/file.json.

--definition-compliance-profile (ProjectComplianceProfile)

Il profilo richiesto per la conformità. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-compliance-profile=@path/to/file.json.

--definition-locator-id (stringa)

Una concatenazione univoca dell'ID catalogo e dell'ID versione che identifica l'architettura distribuibile nel catalogo. Se si importa da un'area di lavoro Schematics esistente che non è supportata dal carrello, è necessario un locator_id. Se si utilizza un'area di lavoro Schematics supportata da un carrello, non è necessario un locator_id perché l'area di lavoro Schematics ne possiede uno.

Ci sono 3 scenari:

1. Se viene specificato solo un locator_id, viene istanziata una nuova area di lavoro Schematics con tale locator_id.
2. Se viene specificato solo uno schema workspace_crn, viene restituito un 400 se non viene trovato un locator_id nello spazio di lavoro schematics esistente.
3. Se vengono specificati sia Schematics workspace_crn che locator_id, viene restituito un messaggio 400 se il locator_id specificato non è in accordo con locator_id nello spazio di lavoro Schematics esistente. Per ulteriori informazioni sulla creazione di uno spazio di lavoro Schematics, vedere Creazione di spazi di lavoro e importazione del modello Terraform. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 512 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)[\\.0-9a-z-A-Z_-]+$/.

--definition-members (StackMember[])

Le architetture distribuibili membro che sono incluse nello stack. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 100 articoli. La lunghezza minima è 0 articoli.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-members=@path/to/file.json.

--definition-uses (ProjectConfigUses[])

Le architetture deployabe dipendenti a cui fa riferimento questa configurazione. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 100 articoli. La lunghezza minima è 0 articoli.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-uses=@path/to/file.json.

--definition-description (stringa)

Una descrizione di configurazione del progetto. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 1024 caratteri. La lunghezza minima è di 0 caratteri. Il valore deve corrispondere all'espressione regolare /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/.

--definition-name (stringa)

Il nome della configurazione. È unico all'interno dell'account tra progetti e regioni. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 128 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^[a-zA-Z0-9][a-zA-Z0-9-_ ]*$/.

--definition-authorizations (ProjectConfigAuth)

I dettagli dell'autorizzazione. Puoi autorizzare utilizzando un profilo attendibile o una chiave API in Secrets Manager. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-authorizations=@path/to/file.json.

--definition-inputs (mappa generica)

Le variabili di input utilizzate per la definizione di configurazione e l'ambiente. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-inputs=@path/to/file.json.

--definition-settings (mappa generica)

Le variabili di ambiente Schematics da utilizzare per distribuire la configurazione. Le impostazioni sono disponibili solo se vengono specificate quando la configurazione viene inizialmente creata. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-settings=@path/to/file.json.

--definition-environment-id (stringa)

L'ID dell'ambiente del progetto. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--definition-resource-crns (stringa[])

I CRN delle risorse associate a questa configurazione. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Gli elementi dell'elenco devono corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)(crn)[^'"`<>{}\\s\\x00-\\x1F]*$/. La lunghezza massima è di 110 articoli. La lunghezza minima è 0 articoli.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempi

ibmcloud project config-update \
    --project-id exampleString \
    --id exampleString \
    --definition '{"compliance_profile": {}, "locator_id": "exampleString", "members": [{"name": "exampleString", "config_id": "exampleString"}], "description": "exampleString", "name": "env-stage", "authorizations": {"trusted_profile_id": "exampleString", "method": "exampleString", "api_key": "exampleString"}, "inputs": {"anyKey": "anyValue"}, "settings": {"anyKey": "anyValue"}, "environment_id": "exampleString"}'

In alternativa, sono disponibili opzioni granulari per i sottocampi delle opzioni della stringa JSON:

ibmcloud project config-update \
    --project-id exampleString \
    --id exampleString \
    --definition-compliance-profile projectComplianceProfile \
    --definition-locator-id exampleString \
    --definition-members '[stackMember]' \
    --definition-uses '[projectConfigUses]' \
    --definition-description exampleString \
    --definition-name exampleString \
    --definition-authorizations projectConfigAuth \
    --definition-inputs '{"anyKey": "anyValue"}' \
    --definition-settings '{"anyKey": "anyValue"}' \
    --definition-environment-id exampleString

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

Esempio

ibmcloud project config-delete \
    --project-id exampleString \
    --id exampleString

Output di esempio

La risposta di esempio a una richiesta di eliminare una configurazione.

{
  "id" : "293c3c36-a094-4115-a12b-de0a9ca39be5"
}

Opzioni comando

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--comment (stringa)

Note sull'azione bozza del progetto. Se questa azione è una forza di approvazione sulla bozza di configurazione, deve includere un commento non vuoto. Obbligatorio.

La lunghezza massima è di 1024 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project config-force-approve \
    --project-id exampleString \
    --id exampleString \
    --comment 'Approving the changes'

Output di esempio

La risposta di esempio a una richiesta per una bozza di configurazione dell'architettura distribuibile.

{
  "id" : "293c3c36-a094-4115-a12b-de0a9ca39be5",
  "definition" : {
    "name" : "env-stage",
    "description" : "The stage environment configuration.",
    "locator_id" : "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global",
    "inputs" : {
      "account_id" : "ref:/configs/account-stage/inputs/account_id",
      "resource_group" : "stage",
      "access_tags" : [ "env:stage" ],
      "logdna_name" : "The name of the LogDNA stage service instance.",
      "sysdig_name" : "The name of the SysDig stage service instance."
    }
  },
  "is_draft" : true,
  "version" : 2,
  "outputs" : [ {
    "name" : "resource_group_id"
  }, {
    "name" : "logdna_id"
  }, {
    "name" : "sysdig_id"
  } ],
  "project" : {
    "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "name" : "iaas-infra-prestage-env"
    },
    "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
  },
  "schematics" : {
    "workspace_crn" : "crn:v1:staging:public:schematics:us-south:a/38acaf4469814090a4e675dc0c317a0d:95ad49de-ab96-4e7d-a08c-45c38aa448e6:workspace:us-south.workspace.service.e0106139"
  },
  "state" : "validated",
  "update_available" : true,
  "needs_attention_state" : [ ],
  "created_at" : "2023-02-22T19:51:23.253Z",
  "modified_at" : "2023-02-22T19:51:23.253Z",
  "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/b0c44146-1ef6-40c2-82ba-74d51149770a",
  "deployment_model" : "project_deployed",
  "references" : { }
}

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--comment (stringa)

Note sull'azione bozza del progetto. Se questa azione è una forza di approvazione sulla bozza di configurazione, deve includere un commento non vuoto.

La lunghezza massima è di 1024 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project config-approve \
    --project-id exampleString \
    --id exampleString \
    --comment 'Approving the changes'

Output di esempio

La risposta di esempio a una richiesta per una bozza di configurazione dell'architettura distribuibile.

{
  "id" : "293c3c36-a094-4115-a12b-de0a9ca39be5",
  "definition" : {
    "name" : "env-stage",
    "description" : "The stage environment configuration.",
    "locator_id" : "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global",
    "inputs" : {
      "account_id" : "ref:/configs/account-stage/inputs/account_id",
      "resource_group" : "stage",
      "access_tags" : [ "env:stage" ],
      "logdna_name" : "The name of the LogDNA stage service instance.",
      "sysdig_name" : "The name of the SysDig stage service instance."
    }
  },
  "is_draft" : true,
  "version" : 2,
  "outputs" : [ {
    "name" : "resource_group_id"
  }, {
    "name" : "logdna_id"
  }, {
    "name" : "sysdig_id"
  } ],
  "project" : {
    "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "name" : "iaas-infra-prestage-env"
    },
    "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
  },
  "schematics" : {
    "workspace_crn" : "crn:v1:staging:public:schematics:us-south:a/38acaf4469814090a4e675dc0c317a0d:95ad49de-ab96-4e7d-a08c-45c38aa448e6:workspace:us-south.workspace.service.e0106139"
  },
  "state" : "validated",
  "update_available" : true,
  "needs_attention_state" : [ ],
  "created_at" : "2023-02-22T19:51:23.253Z",
  "modified_at" : "2023-02-22T19:51:23.253Z",
  "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/b0c44146-1ef6-40c2-82ba-74d51149770a",
  "deployment_model" : "project_deployed",
  "references" : { }
}

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project config-validate \
    --project-id exampleString \
    --id exampleString

Output di esempio

La risposta di esempio a una richiesta per una bozza di configurazione dell'architettura distribuibile.

{
  "id" : "293c3c36-a094-4115-a12b-de0a9ca39be5",
  "definition" : {
    "name" : "env-stage",
    "description" : "The stage environment configuration.",
    "locator_id" : "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global",
    "inputs" : {
      "account_id" : "ref:/configs/account-stage/inputs/account_id",
      "resource_group" : "stage",
      "access_tags" : [ "env:stage" ],
      "logdna_name" : "The name of the LogDNA stage service instance.",
      "sysdig_name" : "The name of the SysDig stage service instance."
    }
  },
  "is_draft" : true,
  "version" : 2,
  "outputs" : [ {
    "name" : "resource_group_id"
  }, {
    "name" : "logdna_id"
  }, {
    "name" : "sysdig_id"
  } ],
  "project" : {
    "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "name" : "iaas-infra-prestage-env"
    },
    "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
  },
  "schematics" : {
    "workspace_crn" : "crn:v1:staging:public:schematics:us-south:a/38acaf4469814090a4e675dc0c317a0d:95ad49de-ab96-4e7d-a08c-45c38aa448e6:workspace:us-south.workspace.service.e0106139"
  },
  "state" : "validated",
  "update_available" : true,
  "needs_attention_state" : [ ],
  "created_at" : "2023-02-22T19:51:23.253Z",
  "modified_at" : "2023-02-22T19:51:23.253Z",
  "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/b0c44146-1ef6-40c2-82ba-74d51149770a",
  "deployment_model" : "project_deployed",
  "references" : { }
}

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--definition (ProjectConfigDefinitionPrototype)

Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition=@path/to/file.json.

--schematics (SchematicsWorkspace)

Uno spazio di lavoro Schematics da utilizzare per la distribuzione di questa architettura distribuibile.

Se si importano i dati da un'area di lavoro esistente di Schematics che non è supportata da un carrello, è necessario fornire un'area locator_id. Se si utilizza un'area di lavoro Schematics supportata da un carrello, non è necessario un locator_id perché l'area di lavoro Schematics ne ha uno.

Ci sono 3 scenari:

1. Se viene specificato solo un locator_id, viene istanziata una nuova area di lavoro Schematics con tale locator_id.
2. Se viene specificato solo uno schema workspace_crn, viene restituito un 400 se non viene trovato un locator_id nello spazio di lavoro schematics esistente.
3. Se vengono specificati sia un Schematics workspace_crn che un locator_id, viene restituito un codice 400 se il locator_id specificato non concorda con il locator_id nell'area di lavoro Schematics esistente.

Per ulteriori informazioni, vedere Creazione di spazi di lavoro e importazione del modello Terraform. Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --schematics=@path/to/file.json.

--definition-compliance-profile (ProjectComplianceProfile)

Il profilo richiesto per la conformità. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-compliance-profile=@path/to/file.json.

--definition-locator-id (stringa)

Una concatenazione univoca dell'ID catalogo e dell'ID versione che identifica l'architettura distribuibile nel catalogo. Se si importa da un'area di lavoro Schematics esistente che non è supportata dal carrello, è necessario un locator_id. Se si utilizza un'area di lavoro Schematics supportata da un carrello, non è necessario un locator_id perché l'area di lavoro Schematics ne possiede uno.

Ci sono 3 scenari:

1. Se viene specificato solo un locator_id, viene istanziata una nuova area di lavoro Schematics con tale locator_id.
2. Se viene specificato solo uno schema workspace_crn, viene restituito un 400 se non viene trovato un locator_id nello spazio di lavoro schematics esistente.
3. Se vengono specificati sia Schematics workspace_crn che locator_id, viene restituito un messaggio 400 se il locator_id specificato non è in accordo con locator_id nello spazio di lavoro Schematics esistente. Per ulteriori informazioni sulla creazione di uno spazio di lavoro Schematics, vedere Creazione di spazi di lavoro e importazione del modello Terraform. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 512 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)[\\.0-9a-z-A-Z_-]+$/.

--definition-members (StackMember[])

Le architetture distribuibili membro che sono incluse nello stack. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 100 articoli. La lunghezza minima è 0 articoli.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-members=@path/to/file.json.

--definition-uses (ProjectConfigUses[])

Le architetture deployabe dipendenti a cui fa riferimento questa configurazione. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 100 articoli. La lunghezza minima è 0 articoli.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-uses=@path/to/file.json.

--definition-description (stringa)

Una descrizione di configurazione del progetto. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Il valore predefinito è . La lunghezza massima è 1024 caratteri. La lunghezza minima è di 0 caratteri. Il valore deve corrispondere all'espressione regolare /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/.

--definition-name (stringa)

Il nome della configurazione. È unico all'interno dell'account tra progetti e regioni. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 128 caratteri. La lunghezza minima è 1. Il valore deve corrispondere all'espressione regolare /^[a-zA-Z0-9][a-zA-Z0-9-_ ]*$/.

--definition-authorizations (ProjectConfigAuth)

I dettagli dell'autorizzazione. Puoi autorizzare utilizzando un profilo attendibile o una chiave API in Secrets Manager. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-authorizations=@path/to/file.json.

--definition-inputs (mappa generica)

Le variabili di input utilizzate per la definizione di configurazione e l'ambiente. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-inputs=@path/to/file.json.

--definition-settings (mappa generica)

Le variabili di ambiente Schematics da utilizzare per distribuire la configurazione. Le impostazioni sono disponibili solo se vengono specificate quando la configurazione viene inizialmente creata. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --definition-settings=@path/to/file.json.

--definition-environment-id (stringa)

L'ID dell'ambiente del progetto. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--definition-resource-crns (stringa[])

I CRN delle risorse associate a questa configurazione. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'definition'. Si esclude a vicenda con tale opzione.

Gli elementi dell'elenco devono corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)(crn)[^'"`<>{}\\s\\x00-\\x1F]*$/. La lunghezza massima è di 110 articoli. La lunghezza minima è 0 articoli.

--schematics-workspace-crn (stringa)

Un nome di risorsa IBM Cloud che identifica in modo univoco una risorsa. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'schematics'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 512 caratteri. La lunghezza minima è di 4 caratteri. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)(crn)[^'"`<>{}\\s\\x00-\\x1F]*$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempi

ibmcloud project config-prevalidate \
    --project-id exampleString \
    --id exampleString \
    --definition '{"compliance_profile": {}, "locator_id": "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global", "members": [{"name": "exampleString", "config_id": "exampleString"}], "description": "The stage environment configuration.", "name": "env-stage", "authorizations": {"trusted_profile_id": "exampleString", "method": "exampleString", "api_key": "exampleString"}, "inputs": {"anyKey": "anyValue"}, "settings": {"anyKey": "anyValue"}, "environment_id": "exampleString"}' \
    --schematics '{"workspace_crn": "crn:v1:staging:public:project:us-south:a/4e1c48fcf8ac33c0a2441e4139f189ae:bf40ad13-b107-446a-8286-c6d576183bb1::"}'

In alternativa, sono disponibili opzioni granulari per i sottocampi delle opzioni della stringa JSON:

ibmcloud project config-prevalidate \
    --project-id exampleString \
    --id exampleString \
    --definition-compliance-profile projectComplianceProfile \
    --definition-locator-id exampleString \
    --definition-members '[stackMember]' \
    --definition-uses '[projectConfigUses]' \
    --definition-description exampleString \
    --definition-name exampleString \
    --definition-authorizations projectConfigAuth \
    --definition-inputs '{"anyKey": "anyValue"}' \
    --definition-settings '{"anyKey": "anyValue"}' \
    --definition-environment-id exampleString \
    --schematics-workspace-crn crn:v1:staging:public:project:us-south:a/4e1c48fcf8ac33c0a2441e4139f189ae:bf40ad13-b107-446a-8286-c6d576183bb1::

Output di esempio

L'oggetto risultato per la prevalidazione.

{
  "result_id" : "293c3c36-a094-4115-a12b-de0a9ca39be5"
}

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--result-id (stringa)

L'identificatore univoco per ottenere gli eventi di prevalutazione. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project get-prevalidate \
    --project-id exampleString \
    --id exampleString \
    --result-id exampleString

Output di esempio

Un esempio di risposta per ottenere risultati prevalenti.

{
  "cost_estimate" : { },
  "cra_logs" : {
    "cra_version" : "2.0.4",
    "status" : "passed"
  },
  "job" : {
    "id" : "ba98208b61efa490153b72adfd672251",
    "summary" : {
      "version" : "1.0.5",
      "plan_summary" : { },
      "apply_summary" : { },
      "destroy_summary" : { },
      "message_summary" : { },
      "plan_messages" : { },
      "apply_messages" : { },
      "destroy_messages" : { }
    }
  },
  "result" : "succeeded"
}

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project config-deploy \
    --project-id exampleString \
    --id exampleString

Output di esempio

La risposta di esempio a una richiesta per una bozza di configurazione dell'architettura distribuibile.

{
  "id" : "293c3c36-a094-4115-a12b-de0a9ca39be5",
  "definition" : {
    "name" : "env-stage",
    "description" : "The stage environment configuration.",
    "locator_id" : "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global",
    "inputs" : {
      "account_id" : "ref:/configs/account-stage/inputs/account_id",
      "resource_group" : "stage",
      "access_tags" : [ "env:stage" ],
      "logdna_name" : "The name of the LogDNA stage service instance.",
      "sysdig_name" : "The name of the SysDig stage service instance."
    }
  },
  "is_draft" : true,
  "version" : 2,
  "outputs" : [ {
    "name" : "resource_group_id"
  }, {
    "name" : "logdna_id"
  }, {
    "name" : "sysdig_id"
  } ],
  "project" : {
    "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "name" : "iaas-infra-prestage-env"
    },
    "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
  },
  "schematics" : {
    "workspace_crn" : "crn:v1:staging:public:schematics:us-south:a/38acaf4469814090a4e675dc0c317a0d:95ad49de-ab96-4e7d-a08c-45c38aa448e6:workspace:us-south.workspace.service.e0106139"
  },
  "state" : "validated",
  "update_available" : true,
  "needs_attention_state" : [ ],
  "created_at" : "2023-02-22T19:51:23.253Z",
  "modified_at" : "2023-02-22T19:51:23.253Z",
  "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/b0c44146-1ef6-40c2-82ba-74d51149770a",
  "deployment_model" : "project_deployed",
  "references" : { }
}

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project config-undeploy \
    --project-id exampleString \
    --id exampleString

Output di esempio

La risposta di esempio a una richiesta per una bozza di configurazione dell'architettura distribuibile.

{
  "id" : "293c3c36-a094-4115-a12b-de0a9ca39be5",
  "definition" : {
    "name" : "env-stage",
    "description" : "The stage environment configuration.",
    "locator_id" : "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global",
    "inputs" : {
      "account_id" : "ref:/configs/account-stage/inputs/account_id",
      "resource_group" : "stage",
      "access_tags" : [ "env:stage" ],
      "logdna_name" : "The name of the LogDNA stage service instance.",
      "sysdig_name" : "The name of the SysDig stage service instance."
    }
  },
  "is_draft" : true,
  "version" : 2,
  "outputs" : [ {
    "name" : "resource_group_id"
  }, {
    "name" : "logdna_id"
  }, {
    "name" : "sysdig_id"
  } ],
  "project" : {
    "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "name" : "iaas-infra-prestage-env"
    },
    "crn" : "crn:v1:staging:public:project:us-south:a/06580c923e40314421d3b6cb40c01c68:cfbf9050-ab8e-ac97-b01b-ab5af830be8a::",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
  },
  "schematics" : {
    "workspace_crn" : "crn:v1:staging:public:schematics:us-south:a/38acaf4469814090a4e675dc0c317a0d:95ad49de-ab96-4e7d-a08c-45c38aa448e6:workspace:us-south.workspace.service.e0106139"
  },
  "state" : "validated",
  "update_available" : true,
  "needs_attention_state" : [ ],
  "created_at" : "2023-02-22T19:51:23.253Z",
  "modified_at" : "2023-02-22T19:51:23.253Z",
  "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/configs/b0c44146-1ef6-40c2-82ba-74d51149770a",
  "deployment_model" : "project_deployed",
  "references" : { }
}

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--schematics (SchematicsWorkspace)

Uno spazio di lavoro Schematics da utilizzare per la distribuzione di questa architettura distribuibile.

Se si importano i dati da un'area di lavoro esistente di Schematics che non è supportata da un carrello, è necessario fornire un'area locator_id. Se si utilizza un'area di lavoro Schematics supportata da un carrello, non è necessario un locator_id perché l'area di lavoro Schematics ne ha uno.

Ci sono 3 scenari:

1. Se viene specificato solo un locator_id, viene istanziata una nuova area di lavoro Schematics con tale locator_id.
2. Se viene specificato solo uno schema workspace_crn, viene restituito un 400 se non viene trovato un locator_id nello spazio di lavoro schematics esistente.
3. Se vengono specificati sia un Schematics workspace_crn che un locator_id, viene restituito un codice 400 se il locator_id specificato non concorda con il locator_id nell'area di lavoro Schematics esistente.

Per ulteriori informazioni, vedere Creazione di spazi di lavoro e importazione del modello Terraform. Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --schematics=@path/to/file.json.

--schematics-workspace-crn (stringa)

Un nome di risorsa IBM Cloud che identifica in modo univoco una risorsa. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'schematics'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 512 caratteri. La lunghezza minima è di 4 caratteri. Il valore deve corrispondere all'espressione regolare /^(?!\\s)(?!.*\\s$)(crn)[^'"`<>{}\\s\\x00-\\x1F]*$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempi

ibmcloud project config-sync \
    --project-id exampleString \
    --id exampleString \
    --schematics '{"workspace_crn": "crn:v1:staging:public:schematics:us-south:a/38acaf4469814090a4e675dc0c317a0d:95ad49de-ab96-4e7d-a08c-45c38aa448e6:workspace:us-south.workspace.service.e0106139"}'

In alternativa, sono disponibili opzioni granulari per i sottocampi delle opzioni della stringa JSON:

ibmcloud project config-sync \
    --project-id exampleString \
    --id exampleString \
    --schematics-workspace-crn crn:v1:staging:public:project:us-south:a/4e1c48fcf8ac33c0a2441e4139f189ae:bf40ad13-b107-446a-8286-c6d576183bb1::

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project config-resources \
    --project-id exampleString \
    --id exampleString

Output di esempio

La risposta di esempio a una richiesta per ottenere le risorse di configurazione di progetto.

{
  "resources" : [ {
    "resource_crn" : "crn:v1:staging:public:toolchain:us-south:a/4e1c48fcf8ac33c0a2441e4139f189ae:bf40ad13-b107-446a-8286-c6d576183bb1::",
    "resource_name" : "toolchain_instance",
    "resource_type" : "ibm_cd_toolchain",
    "resource_tainted" : false,
    "resource_group_name" : "",
    "account_id" : "499b176abb3e1c9727df87ae48b27c7b",
    "location" : "us-south",
    "resource_status" : "active",
    "tags" : [ ],
    "service_tags" : [ ],
    "catalog_tags" : [ ]
  }, {
    "resource_crn" : "crn:v1:staging:public:cloud-object-storage:global:a/4e1c48fcf8ac33c0a2441e4139f189ae:bf40ad13-b107-446a-8286-c6d576183bb1::",
    "resource_name" : "cos_bucket_instance",
    "resource_type" : "ibm_cos_bucket",
    "resource_tainted" : false,
    "resource_group_name" : "",
    "account_id" : "499b176abb3e1c9727df87ae48b27c7b",
    "location" : "us-south",
    "resource_status" : "active",
    "tags" : [ ],
    "service_tags" : [ ],
    "catalog_tags" : [ ]
  } ],
  "resources_count" : 2
}

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--stack-definition (StackDefinitionBlockPrototype)

Il blocco di definizione per una definizione di stack. Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --stack-definition=@path/to/file.json.

--stack-definition-inputs (StackDefinitionInputVariable[])

Definisce gli input che gli utenti devono configurare a livello di stack. Questi input sono inclusi nella voce di catalogo quando lo stack di architettura distribuibile viene esportato in un catalogo privato. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'stack-definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 300 articoli. La lunghezza minima è 0 articoli.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --stack-definition-inputs=@path/to/file.json.

--stack-definition-outputs (StackDefinitionOutputVariable[])

Gli output associati a questa definizione di stack. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'stack-definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 100 articoli. La lunghezza minima è 0 articoli.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --stack-definition-outputs=@path/to/file.json.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempi

ibmcloud project stack-definition-create \
    --project-id exampleString \
    --id exampleString \
    --stack-definition '{"inputs": [{"name": "region", "type": "string", "description": "The IBM Cloud location where a resource is deployed.", "default": "us-south", "required": true, "hidden": false}], "outputs": [{"name": "vpc_cluster_id", "value": "cluster_id"}]}'

In alternativa, sono disponibili opzioni granulari per i sottocampi delle opzioni della stringa JSON:

ibmcloud project stack-definition-create \
    --project-id exampleString \
    --id exampleString \
    --stack-definition-inputs '[stackDefinitionInputVariable]' \
    --stack-definition-outputs '[stackDefinitionOutputVariable]'

Output di esempio

Risposta di esempio da un'operazione di creazione del modello di stack.

{
  "id" : "293c3c36-a094-4115-a12b-de0a9ca6678a",
  "stack_definition" : {
    "inputs" : [ {
      "name" : "region",
      "type" : "string",
      "required" : true,
      "default" : "us-south",
      "hidden" : false,
      "description" : "The IBM Cloud location where a resource is deployed."
    }, {
      "name" : "resource_group",
      "type" : "string",
      "default" : "Default",
      "required" : true,
      "hidden" : false,
      "description" : "The IBM Cloud resource group where a resource is deployed."
    } ],
    "outputs" : [ {
      "name" : "vpc_cluster_id",
      "value" : "cluster_id"
    } ],
    "members" : [ {
      "name" : "foundation-deployable-architecture",
      "version_locator" : "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global",
      "inputs" : [ {
        "name" : "region",
        "value" : "us-south"
      }, {
        "name" : "cluster_name",
        "value" : "foundation-cluster"
      } ]
    }, {
      "name" : "middleware-architecture",
      "version_locator" : "01e1a9ad-534b-4ab9-996a-b8f2a8653d5c.4d86732e-04b9-4dab-bfdc-5b514d86ecd8",
      "inputs" : [ {
        "name" : "kube_version",
        "value" : 1.29
      } ]
    } ]
  },
  "created_at" : "2023-02-22T19:51:23.253Z",
  "modified_at" : "2023-02-22T19:51:23.253Z",
  "configuration" : {
    "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "name" : "stack-bottom-up-example"
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
  },
  "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/template",
  "references" : { }
}

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project stack-definition \
    --project-id exampleString \
    --id exampleString

Output di esempio

Risposta di esempio da un'operazione di creazione del modello di stack.

{
  "id" : "293c3c36-a094-4115-a12b-de0a9ca6678a",
  "stack_definition" : {
    "inputs" : [ {
      "name" : "region",
      "type" : "string",
      "required" : true,
      "default" : "us-south",
      "hidden" : false,
      "description" : "The IBM Cloud location where a resource is deployed."
    }, {
      "name" : "resource_group",
      "type" : "string",
      "default" : "Default",
      "required" : true,
      "hidden" : false,
      "description" : "The IBM Cloud resource group where a resource is deployed."
    } ],
    "outputs" : [ {
      "name" : "vpc_cluster_id",
      "value" : "cluster_id"
    } ],
    "members" : [ {
      "name" : "foundation-deployable-architecture",
      "version_locator" : "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global",
      "inputs" : [ {
        "name" : "region",
        "value" : "us-south"
      }, {
        "name" : "cluster_name",
        "value" : "foundation-cluster"
      } ]
    }, {
      "name" : "middleware-architecture",
      "version_locator" : "01e1a9ad-534b-4ab9-996a-b8f2a8653d5c.4d86732e-04b9-4dab-bfdc-5b514d86ecd8",
      "inputs" : [ {
        "name" : "kube_version",
        "value" : 1.29
      } ]
    } ]
  },
  "created_at" : "2023-02-22T19:51:23.253Z",
  "modified_at" : "2023-02-22T19:51:23.253Z",
  "configuration" : {
    "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "name" : "stack-bottom-up-example"
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
  },
  "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/template",
  "references" : { }
}

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--stack-definition (StackDefinitionBlockPrototype)

Il blocco di definizione per una definizione di stack. Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --stack-definition=@path/to/file.json.

--stack-definition-inputs (StackDefinitionInputVariable[])

Definisce gli input che gli utenti devono configurare a livello di stack. Questi input sono inclusi nella voce di catalogo quando lo stack di architettura distribuibile viene esportato in un catalogo privato. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'stack-definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 300 articoli. La lunghezza minima è 0 articoli.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --stack-definition-inputs=@path/to/file.json.

--stack-definition-outputs (StackDefinitionOutputVariable[])

Gli output associati a questa definizione di stack. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'stack-definition'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 100 articoli. La lunghezza minima è 0 articoli.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --stack-definition-outputs=@path/to/file.json.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempi

ibmcloud project stack-definition-update \
    --project-id exampleString \
    --id exampleString \
    --stack-definition '{"inputs": [{"name": "region", "type": "string", "description": "The IBM Cloud location where a resource is deployed.", "default": "eu-gb", "required": true, "hidden": false}], "outputs": [{"name": "exampleString", "value": "exampleString"}]}'

In alternativa, sono disponibili opzioni granulari per i sottocampi delle opzioni della stringa JSON:

ibmcloud project stack-definition-update \
    --project-id exampleString \
    --id exampleString \
    --stack-definition-inputs '[stackDefinitionInputVariable]' \
    --stack-definition-outputs '[stackDefinitionOutputVariable]'

Output di esempio

Risposta di esempio da un'operazione del modello di stack di patch.

{
  "id" : "293c3c36-a094-4115-a12b-de0a9ca6678a",
  "stack_definition" : {
    "inputs" : [ {
      "name" : "region",
      "type" : "string",
      "required" : true,
      "default" : "eu-gb",
      "hidden" : false,
      "description" : "The IBM Cloud location where a resource is deployed."
    } ],
    "outputs" : [ {
      "name" : "vpc_cluster_id",
      "value" : "cluster_id"
    } ],
    "members" : [ {
      "name" : "foundation-deployable-architecture",
      "version_locator" : "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global",
      "inputs" : [ {
        "name" : "cluster_name",
        "value" : "foundation-cluster"
      } ]
    } ]
  },
  "state" : "draft",
  "created_at" : "2023-02-22T19:51:23.253Z",
  "modified_at" : "2023-02-22T19:51:23.253Z",
  "configuration" : {
    "id" : "cfbf9050-ab8e-ac97-b01b-ab5af830be8a",
    "definition" : {
      "name" : "stack-bottom-up-example"
    },
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a"
  },
  "href" : "https://projects.api.cloud.ibm.com/v1/projects/cfbf9050-ab8e-ac97-b01b-ab5af830be8a/template"
}

Opzioni comando

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--settings (StackDefinitionExportRequest)

Il payload per la richiesta di esportazione del catalogo privato. Questa opzione JSON può essere invece fornita impostando singoli campi con altre opzioni. Si esclude a vicenda con queste opzioni.

Fornire un'opzione stringa JSON o specificare un file JSON da cui leggere fornendo un'opzione filepath che inizia con @, ad esempio --settings=@path/to/file.json.

--settings-catalog-id (stringa)

L'ID catalogo da pubblicare. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'settings'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 36 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\-0-9a-zA-Z]+$/.

--settings-target-version (stringa)

Il valore semver di questa nuova versione del prodotto. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'settings'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 60 caratteri. La lunghezza minima è di 5 caratteri. Il valore deve corrispondere all'espressione regolare /^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$/.

--settings-variation (stringa)

La variante del software attuale che viene imbarcata. Valido solo se il tipo di prodotto è un modulo o una soluzione. Vedere flavor nell'offerta di importazione del catalogo. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'settings'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[a-zA-Z0-9][a-zA-Z0-9-_ ]*$/.

--settings-label (stringa)

L'etichetta del prodotto. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'settings'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[a-zA-Z0-9][a-zA-Z0-9-_ ]*$/.

--settings-tags (stringa[])

Tag associate al prodotto del catalogo. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'settings'. Si esclude a vicenda con tale opzione.

Il valore predefinito è []. Gli elementi dell'elenco devono corrispondere all'espressione regolare /^[a-zA-Z0-9][a-zA-Z0-9-_]*$/. La lunghezza massima è di 10 articoli. La lunghezza minima è 0 articoli.

--settings-product-id (stringa)

L'ID prodotto da pubblicare. Questa opzione fornisce un valore per un campo secondario dell'opzione JSON 'settings'. Si esclude a vicenda con tale opzione.

La lunghezza massima è di 36 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\-0-9a-zA-Z]+$/.

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--output (stringa)

Scegliere un formato di output, che può essere 'json', 'yaml', 'tui' o 'table'. (predefinito 'tabella')

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempi

ibmcloud project stack-definition-export \
    --project-id exampleString \
    --id exampleString \
    --settings '{"catalog_id": "01e1a9ad-534b-4ab9-996a-b8f2a8653d5c", "target_version": "exampleString", "variation": "exampleString", "label": "Stack Deployable Architecture", "tags": []}'

In alternativa, sono disponibili opzioni granulari per i sottocampi delle opzioni della stringa JSON:

ibmcloud project stack-definition-export \
    --project-id exampleString \
    --id exampleString \
    --settings-catalog-id exampleString \
    --settings-target-version exampleString \
    --settings-variation exampleString \
    --settings-label exampleString \
    --settings-tags '[]'

Output di esempio

Risposta di esempio dall'esportazione di una definizione di stack nel catalogo privato

{
  "catalog_id" : "01e1a9ad-534b-4ab9-996a-b8f2a8653d5c",
  "product_id" : "b60b5876-d074-478a-ac73-f979898c527b",
  "version_locator" : "01e1a9ad-534b-4ab9-996a-b8f2a8653d5c.f9f73bdb-5c7d-4ea6-82ef-9debc6340df8",
  "kind" : "terraform",
  "format" : "stack",
  "tags" : [ ]
}

Opzioni comando

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project config-versions \
    --project-id exampleString \
    --id exampleString

Output di esempio

La risposta di esempio a una richiesta di elencare le bozze di configurazione di progetto.

{
  "versions" : [ {
    "definition" : {
      "locator_id" : "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global"
    },
    "version" : 1,
    "state" : "approved",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/db268db0-160b-4911-8f93-89659000a927/configs/293c3c36-a094-4115-a12b-de0a9ca39be5/versions/1"
  }, {
    "definition" : {
      "locator_id" : "1082e7d2-5e2f-0a11-a3bc-f88a8e1931fc.018edf04-e772-4ca2-9785-03e8e03bef72-global"
    },
    "version" : 2,
    "state" : "validated",
    "href" : "https://projects.api.cloud.ibm.com/v1/projects/db268db0-160b-4911-8f93-89659000a927/configs/293c3c36-a094-4115-a12b-de0a9ca39be5/versions/2"
  } ]
}

Percorso JMES predefinito

Per impostazione predefinita, all'output di questo comando viene applicata una query JMESPath, se non viene fornita dall'utente. La query esatta dipende dallo scenario e dal formato di output richiesto. La condizione per ogni query JMESPath predefinita è riportata nella tabella seguente:

Se viene fornita una query JMESPath personalizzata, questa sostituirà qualsiasi JMESPath della tabella precedente.

Opzioni comando

--project-id (stringa)

L'ID progetto univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--version (int64)

La versione della configurazione. Obbligatorio.

Il valore massimo è 10000. Il valore minimo è 0.

-q, --quiet (bool)

Elimina i messaggi dettagliati.

Esempio

ibmcloud project config-version \
    --project-id exampleString \
    --id exampleString \
    --version 0

Opzioni comando

--project-id (stringa)

L'ID progetto univoco. Richiesto se il progetto non è selezionato.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--id (stringa)

L'ID di configurazione univoco. Obbligatorio.

La lunghezza massima è di 128 caratteri. Il valore deve corrispondere all'espressione regolare /^[\\.\\-0-9a-zA-Z]+$/.

--version (int64)

La versione della configurazione. Obbligatorio.

Il valore massimo è 10000. Il valore minimo è 0.

Esempio

ibmcloud project config-version-delete \
    --project-id exampleString \
    --id exampleString \
    --version 0

Output di esempio

La risposta di esempio a una richiesta di eliminare una configurazione.

{
  "id" : "293c3c36-a094-4115-a12b-de0a9ca39be5"
}