예제

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

또는 프로젝트 이름으로 선택할 수도 있습니다

ibmcloud project select ProjectA

프로젝트 선택을 취소하려면

ibmcloud project select --unset-project

명령 옵션

--unset-project (부울)

설정되지 않은 대상 프로젝트

--output (문자열)

출력 형식을 선택합니다. 'json' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 '테이블')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

ibmcloud project select --unset-project

명령 옵션

--definition (ProjectPrototypeDefinition)

프로젝트의 정의입니다. 대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--location (문자열)

리소스가 배치되는 IBM Cloud 위치입니다. 필수.

허용 가능한 값은 us-south, us-east, eu-gb, eu-de, ca-tor 입니다.

--resource-group (문자열)

프로젝트의 데이터 및 도구가 작성되는 자원 그룹 이름입니다. 필수.

최대 길이는 64자입니다. 최소 길이는 0자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)[^'"`<>{}\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--configs (ProjectConfigPrototype[])

프로젝트 구성입니다. 이러한 구성은 구성 배열이 요청 페이로드에 지정된 경우에만 프로젝트 작성 응답에 포함됩니다.

기본값은 []입니다. 최대 길이는 100 항목입니다. 최소 길이는 0 항목입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --configs=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--environments (EnvironmentPrototype[])

프로젝트 환경입니다. 이러한 환경은 환경 배열이 요청 페이로드에 지정된 경우에만 프로젝트 작성 응답에 포함됩니다.

기본값은 []입니다. 최대 길이는 20 항목입니다. 최소 길이는 0 항목입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --environments=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-name (문자열)

프로젝트 이름입니다. 지역별 계정 내에서 고유합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 128자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)[^'"`\/<>{}\\x00-\\x1F]+$/(과)와 일치해야 합니다.

--definition-description (문자열)

배치 가능한 아키텍처의 구성에서 프로젝트의 사용에 대한 간략한 설명입니다. 설명을 제공하지 않고 프로젝트를 만들 수 있습니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

기본값은 입니다. 최대 길이는 1024 자입니다. 최소 길이는 0자입니다. 값은 정규식 /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--definition-auto-deploy-mode (문자열)

자동 배포에 대한 고급 설정으로, 자동 배포가 활성화된 경우 자동 배포가 어떻게 작동해야 하는지 알려줍니다. 두 개의 옵션이 있습니다.

1. auto_approval 는 사용자 확인 없이 유효성을 검사한 후 자동으로 구성을 승인합니다.
2. manual_approval 는 구성 배포가 시작되기 전에 유효성을 검사한 후 구성을 승인하기 위해 사용자 확인을 요구합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

기본값은 manual_approval입니다. 허용되는 값은 다음과 같습니다: auto_approval, manual_approval.

--definition-monitoring-enabled (부울)

자동 드리프트 발견을 사용으로 설정하는 부울 플래그입니다. 이 필드를 사용하여 매일 확인을 실행하여 배포된 리소스와 구성을 비교하여 차이점을 감지합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

기본값은 false입니다.

--definition-destroy-on-delete (부울)

프로젝트가 삭제될 때 자원이 배치 해제되었는지 여부를 표시하는 정책입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

기본값은 true입니다.

--definition-store (ProjectDefinitionStore)

프로젝트 구성을 사용자 지정하는 데 필요한 세부 정보입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-store=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-terraform-engine (ProjectTerraformEngineSettings)

실험용 스키마 - 프로토타입 제작을 위한 것입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-terraform-engine=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-auto-deploy (부울)

자동으로 구성을 배포할 수 있도록 설정하는 부울 플래그입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

기본값은 false입니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예제

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

또는 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

명령 옵션

--token (문자열)

서버는 이 매개변수를 사용하여 다음 페이지에서 리턴되는 첫 번째 항목을 판별합니다. 이 매개변수를 지정하지 않으면 논리적 첫 번째 페이지가 리턴됩니다.

기본값은 입니다. 최대 길이는 1536 자입니다. 최소 길이는 0자입니다. 값은 정규식 /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--limit (int64)

반환할 최대 리소스 수입니다. 리턴되는 자원 수는 마지막 페이지를 제외하고 동일합니다.

기본값은 10입니다. 최대 값은 100 입니다. 최소값은 1입니다.

--all-pages (부울)

목록에 대한 컬렉션의 모든 페이지를 표시하려면 여러 요청을 호출합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

프로젝트를 나열하기 위한 예제 요청입니다.

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

기본 JMESPath

사용자가 제공하지 않은 경우 기본적으로 이 명령의 이 출력에 JMESPath 쿼리가 적용됩니다. 정확한 쿼리는 시나리오와 요청된 출력 형식에 따라 달라집니다. 다음 표에서 각 기본 JMESPath 쿼리의 조건을 확인할 수 있습니다:

사용자 지정 JMESPath 쿼리가 제공되면 위 표에 있는 모든 JMESPath를 대체합니다.

명령 옵션

--id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

예

ibmcloud project get \
    --id exampleString

출력 예

구성이 있는 프로젝트를 검색하기 위한 샘플 응답입니다.

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

기본 JMESPath

사용자가 제공하지 않은 경우 기본적으로 이 명령의 이 출력에 JMESPath 쿼리가 적용됩니다. 정확한 쿼리는 시나리오와 요청된 출력 형식에 따라 달라집니다. 다음 표에서 각 기본 JMESPath 쿼리의 조건을 확인할 수 있습니다:

사용자 지정 JMESPath 쿼리가 제공되면 위 표에 있는 모든 JMESPath를 대체합니다.

명령 옵션

--id (문자열)

고유 프로젝트 ID입니다. 프로젝트를 선택하지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--definition (ProjectDefinitionPatch)

프로젝트의 정의입니다. 대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-name (문자열)

프로젝트 이름입니다. 지역별 계정 내에서 고유합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 128자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)[^'"`\/<>{}\\x00-\\x1F]+$/(과)와 일치해야 합니다.

--definition-description (문자열)

배치 가능한 아키텍처의 구성에서 프로젝트의 사용에 대한 간략한 설명입니다. 설명을 제공하지 않고 프로젝트를 만들 수 있습니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 1024자입니다. 최소 길이는 0자입니다. 값은 정규식 /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--definition-auto-deploy-mode (문자열)

자동 배포에 대한 고급 설정으로, 자동 배포가 활성화된 경우 자동 배포가 어떻게 작동해야 하는지 알려줍니다. 두 개의 옵션이 있습니다.

1. auto_approval 는 사용자 확인 없이 유효성을 검사한 후 자동으로 구성을 승인합니다.
2. manual_approval 는 구성 배포가 시작되기 전에 유효성을 검사한 후 구성을 승인하기 위해 사용자 확인을 요구합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

허용되는 값은 auto_approval, manual_approval입니다.

--definition-monitoring-enabled (부울)

자동 드리프트 발견을 사용으로 설정하는 부울 플래그입니다. 이 필드를 사용하여 매일 확인을 실행하여 배포된 리소스와 구성을 비교하여 차이점을 감지합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

--definition-destroy-on-delete (부울)

프로젝트가 삭제될 때 자원이 배치 해제되었는지 여부를 표시하는 정책입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

--definition-store (ProjectDefinitionStore)

프로젝트 구성을 사용자 지정하는 데 필요한 세부 정보입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-store=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-terraform-engine (ProjectTerraformEngineSettings)

실험용 스키마 - 프로토타입 제작을 위한 것입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-terraform-engine=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-auto-deploy (부울)

자동으로 구성을 배포할 수 있도록 설정하는 부울 플래그입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예제

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}'

또는 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

출력 예

구성이 있는 프로젝트를 검색하기 위한 샘플 응답입니다.

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

명령 옵션

--id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

예

ibmcloud project delete \
    --id exampleString

출력 예

프로젝트 삭제 요청에 대한 응답 예입니다.

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

명령 옵션

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--definition (EnvironmentDefinitionRequiredProperties)

환경 정의입니다. 대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-description (문자열)

환경에 대한 설명입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

기본값은 입니다. 최대 길이는 1024 자입니다. 최소 길이는 0자입니다. 값은 정규식 /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--definition-name (문자열)

환경의 이름입니다. 이는 프로젝트 및 지역 전체의 계정 내에서 고유합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 128자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)[^'"`<>{}\\x00-\\x1F]+$/(과)와 일치해야 합니다.

--definition-authorizations (ProjectConfigAuth)

권한 부여 세부사항입니다. Secrets Manager에서 신뢰할 수 있는 프로파일 또는 API키를 사용하여 권한을 부여할 수 있습니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-authorizations=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-inputs (일반 맵)

구성 정의 및 환경에 사용되는 입력 변수입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-inputs=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-compliance-profile (ProjectComplianceProfile)

준수에 필요한 프로파일입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-compliance-profile=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예제

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

또는 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

출력 예

샘플 환경 응답입니다.

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

명령 옵션

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--token (문자열)

서버는 이 매개변수를 사용하여 다음 페이지에서 리턴되는 첫 번째 항목을 판별합니다. 이 매개변수를 지정하지 않으면 논리적 첫 번째 페이지가 리턴됩니다.

기본값은 입니다. 최대 길이는 1536 자입니다. 최소 길이는 0자입니다. 값은 정규식 /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--limit (int64)

반환할 최대 리소스 수입니다. 리턴되는 자원 수는 마지막 페이지를 제외하고 동일합니다.

기본값은 10입니다. 최대 값은 100 입니다. 최소값은 1입니다.

--all-pages (부울)

여러 요청을 호출하여 환경에 대한 컬렉션의 모든 페이지를 표시합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

목록에 대한 샘플 환경 응답입니다.

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

명령 옵션

--id (문자열)

환경 ID입니다. 필수.

최대 길이는 256자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$).+$/(과)와 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

샘플 환경 응답입니다.

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

명령 옵션

--id (문자열)

환경 ID입니다. 필수.

최대 길이는 256자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$).+$/(과)와 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--definition (EnvironmentDefinitionPropertiesPatch)

업데이트에 사용되는 환경 정의입니다. 대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-description (문자열)

환경에 대한 설명입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 1024자입니다. 최소 길이는 0자입니다. 값은 정규식 /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--definition-name (문자열)

환경의 이름입니다. 이는 프로젝트 및 지역 전체의 계정 내에서 고유합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 128자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)[^'"`<>{}\\x00-\\x1F]+$/(과)와 일치해야 합니다.

--definition-authorizations (ProjectConfigAuth)

권한 부여 세부사항입니다. Secrets Manager에서 신뢰할 수 있는 프로파일 또는 API키를 사용하여 권한을 부여할 수 있습니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-authorizations=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-inputs (일반 맵)

구성 정의 및 환경에 사용되는 입력 변수입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-inputs=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-compliance-profile (ProjectComplianceProfile)

준수에 필요한 프로파일입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-compliance-profile=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예제

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

또는 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

출력 예

샘플 환경 응답입니다.

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

명령 옵션

--id (문자열)

환경 ID입니다. 필수.

최대 길이는 256자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$).+$/(과)와 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

샘플 환경 삭제 응답입니다.

{
  "id" : "env123"
}

명령 옵션

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--definition (ProjectConfigDefinitionPrototype)

대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--schematics (SchematicsWorkspace)

이 배치 가능한 아키텍처를 배치하는 데 사용할 Schematics 작업공간입니다.

카트로 백업되지 않은 기존 Schematics 워크스페이스에서 데이터를 가져오는 경우 locator_id 을 제공해야 합니다. 카트로 지원되는 Schematics 워크스페이스를 사용하는 경우 Schematics 워크스페이스에 locator_id 이 있으므로 필요하지 않습니다.

다음과 같은 세 가지 시나리오가 있습니다.

1. locator_id 만 지정된 경우 새 Schematics 작업공간이 해당 locator_id 로 인스턴스화됩니다.
2. 스키마 workspace_crn 만 지정된 경우, 기존 스키마 작업공간에서 locator_id 를 찾을 수 없으면 400 가 리턴됩니다.
3. Schematics workspace_crn 및 locator_id 을 모두 지정한 경우, 지정된 locator_id 이 기존 Schematics 작업 영역의 locator_id 과 일치하지 않으면 400 코드가 반환됩니다.

자세한 내용은 워크스페이스 만들기 및 테라폼 템플릿 가져오기를 참조하세요. 대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --schematics=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-compliance-profile (ProjectComplianceProfile)

준수에 필요한 프로파일입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-compliance-profile=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-locator-id (문자열)

카탈로그에서 배치 가능한 아키텍처를 식별하는 버전 ID및 카탈로그 ID의 고유한 연결입니다. 카트로 백업되지 않은 기존 Schematics 워크스페이스에서 가져오기하는 경우 locator_id 이 필요합니다. 카트로 지원되는 Schematics 워크스페이스를 사용하는 경우 Schematics 워크스페이스에 워크스페이스가 있으므로 locator_id 은 필요하지 않습니다.

다음과 같은 세 가지 시나리오가 있습니다.

1. locator_id 만 지정된 경우 새 Schematics 작업공간이 해당 locator_id 로 인스턴스화됩니다.
2. 스키마 workspace_crn 만 지정된 경우, 기존 스키마 작업공간에서 locator_id 를 찾을 수 없으면 400 가 리턴됩니다.
3. Schematics workspace_crn 및 locator_id 가 둘 다 지정된 경우 지정된 locator_id 가 기존 Schematics 작업공간의 locator_id 와 일치하지 않으면 400 메시지가 리턴됩니다. Schematics 워크스페이스 만들기에 대한 자세한 내용은 워크스페이스 만들기 및 Terraform 템플릿 가져오기를 참조하세요. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 512자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)[\\.0-9a-z-A-Z_-]+$/(과)와 일치해야 합니다.

--definition-members (StackMember[])

스택에 포함된 멤버 배포 가능한 아키텍처입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 100 항목입니다. 최소 길이는 0 항목입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-members=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-uses (ProjectConfigUses[])

이 구성에서 참조하는 배포 아키텍처에 따라 다릅니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 100 항목입니다. 최소 길이는 0 항목입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-uses=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-description (문자열)

프로젝트 구성 설명입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

기본값은 입니다. 최대 길이는 1024 자입니다. 최소 길이는 0자입니다. 값은 정규식 /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--definition-name (문자열)

구성 이름입니다. 이는 프로젝트 및 지역 전체의 계정 내에서 고유합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 128자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^[a-zA-Z0-9][a-zA-Z0-9-_ ]*$/(과)와 일치해야 합니다.

--definition-authorizations (ProjectConfigAuth)

권한 부여 세부사항입니다. 신뢰할 수 있는 프로필 또는 Secrets Manager 에서 API 키를 사용하여 인증할 수 있습니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-authorizations=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-inputs (일반 맵)

구성 정의 및 환경에 사용되는 입력 변수입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-inputs=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-settings (일반 맵)

구성을 배치하는 데 사용할 Schematics 환경 변수입니다. 설정은 구성이 처음 작성될 때 지정된 경우에만 사용 가능합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-settings=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-environment-id (문자열)

프로젝트 환경의 ID입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--definition-resource-crns ([]문자열)

이 구성과 연관된 자원의 CRN입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

목록 항목은 정규식 /^(?!\\s)(?!.*\\s$)(crn)[^'"`<>{}\\s\\x00-\\x1F]*$/ 과 일치해야 합니다. 최대 길이는 110 항목입니다. 최소 길이는 0 항목입니다.

--schematics-workspace-crn (문자열)

리소스를 고유하게 식별하는 IBM Cloud 리소스 이름입니다. 이 옵션은 JSON 옵션 'schematics' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 512자입니다. 최소 길이는 4자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)(crn)[^'"`<>{}\\s\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예제

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::"}'

또는 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::

명령 옵션

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--token (문자열)

서버는 이 매개변수를 사용하여 다음 페이지에서 리턴되는 첫 번째 항목을 판별합니다. 이 매개변수를 지정하지 않으면 논리적 첫 번째 페이지가 리턴됩니다.

기본값은 입니다. 최대 길이는 1536 자입니다. 최소 길이는 0자입니다. 값은 정규식 /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--limit (int64)

반환할 최대 리소스 수입니다. 리턴되는 자원 수는 마지막 페이지를 제외하고 동일합니다.

기본값은 10입니다. 최대 값은 100 입니다. 최소값은 1입니다.

--all-pages (부울)

여러 요청을 호출하여 구성 컬렉션의 모든 페이지를 표시합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

프로젝트 구성을 가져오기 위한 요청에 대한 예제 응답입니다.

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

기본 JMESPath

사용자가 제공하지 않은 경우 기본적으로 이 명령의 이 출력에 JMESPath 쿼리가 적용됩니다. 정확한 쿼리는 시나리오와 요청된 출력 형식에 따라 달라집니다. 다음 표에서 각 기본 JMESPath 쿼리의 조건을 확인할 수 있습니다:

사용자 지정 JMESPath 쿼리가 제공되면 위 표에 있는 모든 JMESPath를 대체합니다.

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

예

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

기본 JMESPath

사용자가 제공하지 않은 경우 기본적으로 이 명령의 이 출력에 JMESPath 쿼리가 적용됩니다. 정확한 쿼리는 시나리오와 요청된 출력 형식에 따라 달라집니다. 다음 표에서 각 기본 JMESPath 쿼리의 조건을 확인할 수 있습니다:

사용자 지정 JMESPath 쿼리가 제공되면 위 표에 있는 모든 JMESPath를 대체합니다.

명령 옵션

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--definition (ProjectConfigDefinitionPatch)

대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-compliance-profile (ProjectComplianceProfile)

준수에 필요한 프로파일입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-compliance-profile=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-locator-id (문자열)

카탈로그에서 배치 가능한 아키텍처를 식별하는 버전 ID및 카탈로그 ID의 고유한 연결입니다. 카트로 백업되지 않은 기존 Schematics 워크스페이스에서 가져오기하는 경우 locator_id 이 필요합니다. 카트로 지원되는 Schematics 워크스페이스를 사용하는 경우 Schematics 워크스페이스에 워크스페이스가 있으므로 locator_id 은 필요하지 않습니다.

다음과 같은 세 가지 시나리오가 있습니다.

1. locator_id 만 지정된 경우 새 Schematics 작업공간이 해당 locator_id 로 인스턴스화됩니다.
2. 스키마 workspace_crn 만 지정된 경우, 기존 스키마 작업공간에서 locator_id 를 찾을 수 없으면 400 가 리턴됩니다.
3. Schematics workspace_crn 및 locator_id 가 둘 다 지정된 경우 지정된 locator_id 가 기존 Schematics 작업공간의 locator_id 와 일치하지 않으면 400 메시지가 리턴됩니다. Schematics 워크스페이스 만들기에 대한 자세한 내용은 워크스페이스 만들기 및 Terraform 템플릿 가져오기를 참조하세요. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 512자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)[\\.0-9a-z-A-Z_-]+$/(과)와 일치해야 합니다.

--definition-members (StackMember[])

스택에 포함된 멤버 배포 가능한 아키텍처입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 100 항목입니다. 최소 길이는 0 항목입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-members=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-uses (ProjectConfigUses[])

이 구성에서 참조하는 배포 아키텍처에 따라 다릅니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 100 항목입니다. 최소 길이는 0 항목입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-uses=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-description (문자열)

프로젝트 구성 설명입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 1024자입니다. 최소 길이는 0자입니다. 값은 정규식 /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--definition-name (문자열)

구성 이름입니다. 이는 프로젝트 및 지역 전체의 계정 내에서 고유합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 128자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^[a-zA-Z0-9][a-zA-Z0-9-_ ]*$/(과)와 일치해야 합니다.

--definition-authorizations (ProjectConfigAuth)

권한 부여 세부사항입니다. Secrets Manager에서 신뢰할 수 있는 프로파일 또는 API키를 사용하여 권한을 부여할 수 있습니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-authorizations=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-inputs (일반 맵)

구성 정의 및 환경에 사용되는 입력 변수입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-inputs=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-settings (일반 맵)

구성을 배치하는 데 사용할 Schematics 환경 변수입니다. 설정은 구성이 처음 작성될 때 지정된 경우에만 사용 가능합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-settings=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-environment-id (문자열)

프로젝트 환경의 ID입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--definition-resource-crns ([]문자열)

이 구성과 연관된 자원의 CRN입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

목록 항목은 정규식 /^(?!\\s)(?!.*\\s$)(crn)[^'"`<>{}\\s\\x00-\\x1F]*$/ 과 일치해야 합니다. 최대 길이는 110 항목입니다. 최소 길이는 0 항목입니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예제

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

또는 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

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

예

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

출력 예

구성을 삭제하기 위한 요청에 대한 응답 예제입니다.

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

명령 옵션

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--comment (문자열)

프로젝트 초안 조치에 대한 참고사항입니다. 이 작업이 초안 구성에 대한 강제 승인인 경우 비어 있지 않은 댓글을 포함해야 합니다. 필수.

최대 길이는 1024자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]+$/(과)와 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

배치 가능한 아키텍처 구성 초안에 대한 요청의 응답 예입니다.

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

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--comment (문자열)

프로젝트 초안 조치에 대한 참고사항입니다. 이 작업이 초안 구성에 대한 강제 승인인 경우 비어 있지 않은 댓글을 포함해야 합니다.

최대 길이는 1024자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]+$/(과)와 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

배치 가능한 아키텍처 구성 초안에 대한 요청의 응답 예입니다.

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

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

배치 가능한 아키텍처 구성 초안에 대한 요청의 응답 예입니다.

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

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--definition (ProjectConfigDefinitionPrototype)

대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--schematics (SchematicsWorkspace)

이 배치 가능한 아키텍처를 배치하는 데 사용할 Schematics 작업공간입니다.

카트로 백업되지 않은 기존 Schematics 워크스페이스에서 데이터를 가져오는 경우 locator_id 을 제공해야 합니다. 카트로 지원되는 Schematics 워크스페이스를 사용하는 경우 Schematics 워크스페이스에 locator_id 이 있으므로 필요하지 않습니다.

다음과 같은 세 가지 시나리오가 있습니다.

1. locator_id 만 지정된 경우 새 Schematics 작업공간이 해당 locator_id 로 인스턴스화됩니다.
2. 스키마 workspace_crn 만 지정된 경우, 기존 스키마 작업공간에서 locator_id 를 찾을 수 없으면 400 가 리턴됩니다.
3. Schematics workspace_crn 및 locator_id 을 모두 지정한 경우, 지정된 locator_id 이 기존 Schematics 작업 영역의 locator_id 과 일치하지 않으면 400 코드가 반환됩니다.

자세한 내용은 워크스페이스 만들기 및 테라폼 템플릿 가져오기를 참조하세요. 대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --schematics=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-compliance-profile (ProjectComplianceProfile)

준수에 필요한 프로파일입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-compliance-profile=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-locator-id (문자열)

카탈로그에서 배치 가능한 아키텍처를 식별하는 버전 ID및 카탈로그 ID의 고유한 연결입니다. 카트로 백업되지 않은 기존 Schematics 워크스페이스에서 가져오기하는 경우 locator_id 이 필요합니다. 카트로 지원되는 Schematics 워크스페이스를 사용하는 경우 Schematics 워크스페이스에 워크스페이스가 있으므로 locator_id 은 필요하지 않습니다.

다음과 같은 세 가지 시나리오가 있습니다.

1. locator_id 만 지정된 경우 새 Schematics 작업공간이 해당 locator_id 로 인스턴스화됩니다.
2. 스키마 workspace_crn 만 지정된 경우, 기존 스키마 작업공간에서 locator_id 를 찾을 수 없으면 400 가 리턴됩니다.
3. Schematics workspace_crn 및 locator_id 가 둘 다 지정된 경우 지정된 locator_id 가 기존 Schematics 작업공간의 locator_id 와 일치하지 않으면 400 메시지가 리턴됩니다. Schematics 워크스페이스 만들기에 대한 자세한 내용은 워크스페이스 만들기 및 Terraform 템플릿 가져오기를 참조하세요. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 512자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)[\\.0-9a-z-A-Z_-]+$/(과)와 일치해야 합니다.

--definition-members (StackMember[])

스택에 포함된 멤버 배포 가능한 아키텍처입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 100 항목입니다. 최소 길이는 0 항목입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-members=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-uses (ProjectConfigUses[])

이 구성에서 참조하는 배포 아키텍처에 따라 다릅니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 100 항목입니다. 최소 길이는 0 항목입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-uses=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-description (문자열)

프로젝트 구성 설명입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

기본값은 입니다. 최대 길이는 1024 자입니다. 최소 길이는 0자입니다. 값은 정규식 /^$|^(?!\\s)(?!.*\\s$)[^\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--definition-name (문자열)

구성 이름입니다. 이는 프로젝트 및 지역 전체의 계정 내에서 고유합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 128자입니다. 최소 길이는 1 문자입니다. 값은 정규식 /^[a-zA-Z0-9][a-zA-Z0-9-_ ]*$/(과)와 일치해야 합니다.

--definition-authorizations (ProjectConfigAuth)

권한 부여 세부사항입니다. Secrets Manager에서 신뢰할 수 있는 프로파일 또는 API키를 사용하여 권한을 부여할 수 있습니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-authorizations=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-inputs (일반 맵)

구성 정의 및 환경에 사용되는 입력 변수입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-inputs=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-settings (일반 맵)

구성을 배치하는 데 사용할 Schematics 환경 변수입니다. 설정은 구성이 처음 작성될 때 지정된 경우에만 사용 가능합니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --definition-settings=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--definition-environment-id (문자열)

프로젝트 환경의 ID입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--definition-resource-crns ([]문자열)

이 구성과 연관된 자원의 CRN입니다. 이 옵션은 JSON 옵션 '정의' 의 서브필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

목록 항목은 정규식 /^(?!\\s)(?!.*\\s$)(crn)[^'"`<>{}\\s\\x00-\\x1F]*$/ 과 일치해야 합니다. 최대 길이는 110 항목입니다. 최소 길이는 0 항목입니다.

--schematics-workspace-crn (문자열)

리소스를 고유하게 식별하는 IBM Cloud 리소스 이름입니다. 이 옵션은 JSON 옵션 'schematics' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 512자입니다. 최소 길이는 4자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)(crn)[^'"`<>{}\\s\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예제

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::"}'

또는 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::

출력 예

유효성 검사를 위한 결과 객체입니다.

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

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--result-id (문자열)

이벤트 유효성 검사를 위한 고유 식별자입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

사전 유효성 검사 결과를 얻기 위한 응답 예제입니다.

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

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

배치 가능한 아키텍처 구성 초안에 대한 요청의 응답 예입니다.

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

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

배치 가능한 아키텍처 구성 초안에 대한 요청의 응답 예입니다.

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

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--schematics (SchematicsWorkspace)

이 배치 가능한 아키텍처를 배치하는 데 사용할 Schematics 작업공간입니다.

카트로 백업되지 않은 기존 Schematics 워크스페이스에서 데이터를 가져오는 경우 locator_id 을 제공해야 합니다. 카트로 지원되는 Schematics 워크스페이스를 사용하는 경우 Schematics 워크스페이스에 locator_id 이 있으므로 필요하지 않습니다.

다음과 같은 세 가지 시나리오가 있습니다.

1. locator_id 만 지정된 경우 새 Schematics 작업공간이 해당 locator_id 로 인스턴스화됩니다.
2. 스키마 workspace_crn 만 지정된 경우, 기존 스키마 작업공간에서 locator_id 를 찾을 수 없으면 400 가 리턴됩니다.
3. Schematics workspace_crn 및 locator_id 을 모두 지정한 경우, 지정된 locator_id 이 기존 Schematics 작업 영역의 locator_id 과 일치하지 않으면 400 코드가 반환됩니다.

자세한 내용은 워크스페이스 만들기 및 테라폼 템플릿 가져오기를 참조하세요. 대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --schematics=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--schematics-workspace-crn (문자열)

리소스를 고유하게 식별하는 IBM Cloud 리소스 이름입니다. 이 옵션은 JSON 옵션 'schematics' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 512자입니다. 최소 길이는 4자입니다. 값은 정규식 /^(?!\\s)(?!.*\\s$)(crn)[^'"`<>{}\\s\\x00-\\x1F]*$/(과)와 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예제

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

또는 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::

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

프로젝트 구성 자원을 가져오기 위한 요청에 대한 예제 응답입니다.

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

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--stack-definition (StackDefinitionBlockPrototype)

스택 정의의 정의 블록입니다. 대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --stack-definition=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

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

사용자가 스택 레벨에서 구성해야 하는 입력을 정의합니다. 이러한 입력은 배치 가능한 아키텍처 스택을 개인용 카탈로그로 내보낼 때 카탈로그 항목에 포함됩니다. 이 옵션은 JSON 옵션 'stack-definition' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 300 항목입니다. 최소 길이는 0 항목입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --stack-definition-inputs=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

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

이 스택 정의와 연관된 출력입니다. 이 옵션은 JSON 옵션 'stack-definition' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 100 항목입니다. 최소 길이는 0 항목입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --stack-definition-outputs=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예제

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

또는 JSON 문자열 옵션의 하위 필드에 대해 세부 단위의 옵션을 사용할 수 있습니다.

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

출력 예

스택 템플리트 작성 오퍼레이션의 샘플 응답입니다.

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

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

스택 템플리트 작성 오퍼레이션의 샘플 응답입니다.

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

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--stack-definition (StackDefinitionBlockPrototype)

스택 정의의 정의 블록입니다. 대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --stack-definition=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

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

사용자가 스택 레벨에서 구성해야 하는 입력을 정의합니다. 이러한 입력은 배치 가능한 아키텍처 스택을 개인용 카탈로그로 내보낼 때 카탈로그 항목에 포함됩니다. 이 옵션은 JSON 옵션 'stack-definition' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 300 항목입니다. 최소 길이는 0 항목입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --stack-definition-inputs=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

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

이 스택 정의와 연관된 출력입니다. 이 옵션은 JSON 옵션 'stack-definition' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 100 항목입니다. 최소 길이는 0 항목입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --stack-definition-outputs=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예제

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

또는 JSON 문자열 옵션의 하위 필드에 대해 세부 단위의 옵션을 사용할 수 있습니다.

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

출력 예

패치 스택 템플리트 조작의 샘플 응답입니다.

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

명령 옵션

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--settings (StackDefinitionExportRequest)

개인용 카탈로그 내보내기 요청에 대한 페이로드입니다. 대신 다른 옵션으로 개별 필드를 설정하여 이 JSON 옵션을 제공할 수 있습니다. 이러한 옵션과 상호 배타적입니다.

JSON 문자열 옵션을 제공하거나 @ 로 시작하는 파일 경로 옵션(예: --settings=@path/to/file.json)을 제공하여 읽을 JSON 파일을 지정합니다.

--settings-catalog-id (문자열)

공개할 카탈로그 ID입니다. 이 옵션은 JSON 옵션 '설정' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 36자입니다. 값은 정규식 /^[\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--settings-target-version (문자열)

이 새 버전의 제품의 셈버 값입니다. 이 옵션은 JSON 옵션 '설정' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 60자입니다. 최소 길이는 5자입니다. 값은 정규식 /^(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 (문자열)

현재 온보딩 중인 소프트웨어의 변형입니다. 제품 종류가 모듈 또는 솔루션인 경우에만 유효합니다. 카탈로그의 가져오기 오퍼링에서 flavor 을 참조하세요. 이 옵션은 JSON 옵션 '설정' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 128자입니다. 값은 정규식 /^[a-zA-Z0-9][a-zA-Z0-9-_ ]*$/ 과 일치해야 합니다.

--settings-label (문자열)

제품 레이블입니다. 이 옵션은 JSON 옵션 '설정' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 128자입니다. 값은 정규식 /^[a-zA-Z0-9][a-zA-Z0-9-_ ]*$/ 과 일치해야 합니다.

--settings-tags ([]문자열)

카탈로그 상품과 연관된 태그입니다. 이 옵션은 JSON 옵션 '설정' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

기본값은 []입니다. 목록 항목은 정규식 /^[a-zA-Z0-9][a-zA-Z0-9-_]*$/ 과 일치해야 합니다. 최대 길이는 10 항목입니다. 최소 길이는 0 항목입니다.

--settings-product-id (문자열)

공개할 제품 ID입니다. 이 옵션은 JSON 옵션 '설정' 의 하위 필드에 대한 값을 제공합니다. 해당 옵션과 상호 배타적입니다.

최대 길이는 36자입니다. 값은 정규식 /^[\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--output (문자열)

출력 형식을 선택합니다. 'json', 'yaml', 'tui' 또는 'table' 중 하나를 선택할 수 있습니다. (기본값은 'table')

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예제

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": []}'

또는 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 '[]'

출력 예

개인용 카탈로그로 스택 정의를 내보내는 샘플 응답

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

명령 옵션

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

출력 예

프로젝트 구성 초안을 나열하는 요청에 대한 응답 예입니다.

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

기본 JMESPath

사용자가 제공하지 않은 경우 기본적으로 이 명령의 이 출력에 JMESPath 쿼리가 적용됩니다. 정확한 쿼리는 시나리오와 요청된 출력 형식에 따라 달라집니다. 다음 표에서 각 기본 JMESPath 쿼리의 조건을 확인할 수 있습니다:

사용자 지정 JMESPath 쿼리가 제공되면 위 표에 있는 모든 JMESPath를 대체합니다.

명령 옵션

--project-id (문자열)

고유 프로젝트 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--version (int64)

구성 버전입니다. 필수.

최대 값은 10000 입니다. 최소값은 0입니다.

-q, --quiet (부울)

자세한 메시지를 표시하지 않습니다.

예

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

명령 옵션

--project-id (문자열)

고유 프로젝트 ID입니다. 프로젝트가 선택되지 않은 경우 필수입니다.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--id (문자열)

고유한 구성 ID입니다. 필수.

최대 길이는 128자입니다. 값은 정규식 /^[\\.\\-0-9a-zA-Z]+$/ 과 일치해야 합니다.

--version (int64)

구성 버전입니다. 필수.

최대 값은 10000 입니다. 최소값은 0입니다.

예

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

출력 예

구성을 삭제하기 위한 요청에 대한 응답 예제입니다.

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