CloudService #

A CloudService is data of an instance of a resource. A CloudService follows the pre-created classification system of a CloudServiceType and indicates the property value of the resource.

Package : spaceone.api.inventory.v1

CloudService #

CloudService Methods:

Method	Request	Response
create	CreateServiceRequest	CloudServiceInfo
update	UpdateCloudServiceRequest	CloudServiceInfo
delete	CloudServiceRequest	Empty
get	CloudServiceRequest	CloudServiceInfo
list	CloudServiceQuery	CloudServicesInfo
export	CloudServiceExportRequest	Struct
analyze	CloudServiceAnalyzeQuery	Struct
stat	CloudServiceStatQuery	Struct

create #

Creates a new CloudService. A CloudService instance is created based on data including the resource’s attribute values. When creating, the classification information defined by CloudServiceType is also needed. The created CloudService has collection information which is the collection history for the resource by plugin.

POST /inventory/v1/cloud-service/create

Request Example

CreateServiceRequest

cloud_service_type (string) Required
provider (string) Required
cloud_service_group (string) Required
data (Struct) Required
name (string)
account (string)
instance_type (string)
instance_size (float)
ip_addresses (string) Repeated
metadata (Struct)
reference (CloudServiceReference)
tags (Struct)
region_code (string)
project_id (string)

{
   "cloud_service_type": "Key",
   "provider": "aws",
   "cloud_service_group": "KMS",
   "name": "cloud_service_test",
   "account": "251340636361",
   "launched_at": "2020-08-03T15:00:54.000Z",
   "ip_addresses": [],
   "data": {
       "alias_arn": null,
       "origin": "AWS_KMS",
       "cloudwatch": {
           "region_name": "ap-northeast-1",
           "namespace": "AWS/KMS",
           "dimensions": [
               {
                   "Value": "0drda5e1-c40f-45d7-a647-xxxxxxx",
                   "Name": "KeyId"
               }
           ]
       },
       "aws_account_id": "251340636361",
       "creation_date": "2020-07-09T09:39:03.097000+0000",
       "encryption_algorithms": [
           "SYMMETRIC_DEFAULT"
       ],
       "key_usage": "ENCRYPT_DECRYPT",
       "key_id": "0drda5e1-c40f-45d7-a647-xxxxxxx",
       "key_type_path": "defaultKeys",
       "key_rotated": false,
       "description": "Default master key that protects my Secrets Manager data when no other key is defined",
       "key_state": "Enabled",
       "customer_master_key_spec": "SYMMETRIC_DEFAULT",
       "enabled": true,
       "arn": "arn:aws:kms:ap-northeast-1:251340636361:key/0drda5e1-c40f-45d7-a647-xxxxxxx",
       "key_manager": "AWS"
   },
   "metadata": {},
   "reference": {
       "resource_id": "arn:aws:kms:ap-northeast-1:251340636361:key/0drda5e1-c40f-45d7-a647-xxxxxxx",
       "external_link": "https://console.aws.amazon.com/kms/home?region=ap-northeast-1#/kms/defaultKeys/0drda5e1-c40f-45d7-a647-xxxxxxx/"
   },
   "tags": {
       "a": "b"
   },
   "region_code": "ap-northeast-1"
}

Response Example

CloudServiceInfo

cloud_service_id (string) Required
name (string) Required
state (string) Required
ip_addresses (string) Repeated Required
account (string) Required
instance_type (string) Required
instance_size (float) Required
cloud_service_type (string) Required
cloud_service_group (string) Required
provider (string) Required
data (Struct) Required
metadata (Struct) Required
reference (CloudServiceReference) Required
tags (Struct) Required
tag_keys (Struct) Required
collection_info (CollectionInfo) Required
region_code (string) Required
domain_id (string) Required
workspace_id (string) Required
project_id (string) Required
created_at (string) Required
updated_at (string) Required
deleted_at (string) Required

{
   "cloud_service_id": "cloud-svc-c00f38a173e1",
   "name": "cloud_service_test",
   "state": "ACTIVE",
   "account": "251340636361",
   "cloud_service_type": "Key",
   "cloud_service_group": "KMS",
   "provider": "aws",
   "data": {
       "alias_arn": null,
       "origin": "AWS_KMS",
       "cloudwatch": {
           "region_name": "ap-northeast-1",
           "namespace": "AWS/KMS",
           "dimensions": [
               {
                   "Value": "0drda5e1-c40f-45d7-a647-xxxxxxx",
                   "Name": "KeyId"
               }
           ]
       },
       "aws_account_id": "251340636361",
       "creation_date": "2020-07-09T09:39:03.097000+0000",
       "encryption_algorithms": [
           "SYMMETRIC_DEFAULT"
       ],
       "key_usage": "ENCRYPT_DECRYPT",
       "key_id": "0drda5e1-c40f-45d7-a647-xxxxxxx",
       "key_type_path": "defaultKeys",
       "key_rotated": false,
       "description": "Default master key that protects my Secrets Manager data when no other key is defined",
       "key_state": "Enabled",
       "customer_master_key_spec": "SYMMETRIC_DEFAULT",
       "enabled": true,
       "arn": "arn:aws:kms:ap-northeast-1:251340636361:key/0drda5e1-c40f-45d7-a647-xxxxxxx",
       "key_manager": "AWS"
   },
   "metadata": {
       "manual": {}
   },
   "reference": {
       "resource_id": "arn:aws:kms:ap-northeast-1:251340636361:key/0drda5e1-c40f-45d7-a647-xxxxxxx",
       "external_link": "https://console.aws.amazon.com/kms/home?region=ap-northeast-1#/kms/defaultKeys/0drda5e1-c40f-45d7-a647-xxxxxxx/"
   },
   "tags": {
       "a": "b"
   },
   "collection_info": {
       "service_account_id": "sa-abcd1234",
       "secret_id": "secret-abcd1234",
       "collector_id": "collector-abcd1234",
       "last_collected_at": "2022-06-22T06:38:48.989Z"
   },
   "ip_addresses": [],
   "region_code": "ap-northeast-1",
   "workspace_id": "workspace-58010aa2e451",
   "domain_id": "domain-58010aa2e451",
   "created_at": "2022-06-22T06:38:48.989Z",
   "updated_at": "2022-06-22T06:38:48.989Z",
   "launched_at": "2020-08-03T15:00:54.000Z"
}

update #

Updates a specific CloudService. You can make changes in CloudService settings, except for the classification system of CloudService and the information about the resource attribute value.

POST /inventory/v1/cloud-service/update

Request Example

UpdateCloudServiceRequest

cloud_service_id (string) Required
name (string)
account (string)
instance_type (string)
instance_size (float)
ip_addresses (string) Repeated
data (Struct)
metadata (Struct)
reference (CloudServiceReference)
tags (Struct)
region_code (string)
project_id (string)

{
   "cloud_service_id": "cloud-svc-c00f38a173e1",
   "name": "cloud_service_test2",
   "ip_addresses": [
       "1.1.1.1",
       "2.2.2.2"
   ],
   "tags": {
       "description": "spaceone"
   },
   "region_code": "ap-northeast-2"
}

Response Example

CloudServiceInfo

cloud_service_id (string) Required
name (string) Required
state (string) Required
ip_addresses (string) Repeated Required
account (string) Required
instance_type (string) Required
instance_size (float) Required
cloud_service_type (string) Required
cloud_service_group (string) Required
provider (string) Required
data (Struct) Required
metadata (Struct) Required
reference (CloudServiceReference) Required
tags (Struct) Required
tag_keys (Struct) Required
collection_info (CollectionInfo) Required
region_code (string) Required
domain_id (string) Required
workspace_id (string) Required
project_id (string) Required
created_at (string) Required
updated_at (string) Required
deleted_at (string) Required

{
   "cloud_service_id": "cloud-svc-c00f38a173e1",
   "name": "cloud_service_test",
   "state": "ACTIVE",
   "account": "251340636361",
   "cloud_service_type": "Key",
   "cloud_service_group": "KMS",
   "provider": "aws",
   "data": {
       "alias_arn": null,
       "origin": "AWS_KMS",
       "cloudwatch": {
           "region_name": "ap-northeast-1",
           "namespace": "AWS/KMS",
           "dimensions": [
               {
                   "Value": "0drda5e1-c40f-45d7-a647-xxxxxxx",
                   "Name": "KeyId"
               }
           ]
       },
       "aws_account_id": "251340636361",
       "creation_date": "2020-07-09T09:39:03.097000+0000",
       "encryption_algorithms": [
           "SYMMETRIC_DEFAULT"
       ],
       "key_usage": "ENCRYPT_DECRYPT",
       "key_id": "0drda5e1-c40f-45d7-a647-xxxxxxx",
       "key_type_path": "defaultKeys",
       "key_rotated": false,
       "description": "Default master key that protects my Secrets Manager data when no other key is defined",
       "key_state": "Enabled",
       "customer_master_key_spec": "SYMMETRIC_DEFAULT",
       "enabled": true,
       "arn": "arn:aws:kms:ap-northeast-1:251340636361:key/0drda5e1-c40f-45d7-a647-xxxxxxx",
       "key_manager": "AWS"
   },
   "metadata": {
       "manual": {}
   },
   "reference": {
       "resource_id": "arn:aws:kms:ap-northeast-1:251340636361:key/0drda5e1-c40f-45d7-a647-xxxxxxx",
       "external_link": "https://console.aws.amazon.com/kms/home?region=ap-northeast-1#/kms/defaultKeys/0drda5e1-c40f-45d7-a647-xxxxxxx/"
   },
   "tags": {
       "a": "b"
   },
   "collection_info": {
       "service_account_id": "sa-abcd1234",
       "secret_id": "secret-abcd1234",
       "collector_id": "collector-abcd1234",
       "last_collected_at": "2022-06-22T06:38:48.989Z"
   },
   "ip_addresses": [],
   "region_code": "ap-northeast-1",
   "workspace_id": "workspace-58010aa2e451",
   "domain_id": "domain-58010aa2e451",
   "created_at": "2022-06-22T06:38:48.989Z",
   "updated_at": "2022-06-22T06:38:48.989Z",
   "launched_at": "2020-08-03T15:00:54.000Z"
}

delete #

Deletes a specific CloudService. You must specify the cloud_service_id of the CloudService to delete.

POST /inventory/v1/cloud-service/delete

Request Example

CloudServiceRequest

cloud_service_id (string) Required

{
   "cloud_service_id": "cloud-svc-fea2b0d32141"
}

get #

Gets a specific CloudService. Prints detailed information about the CloudService, including its state, classification information, and attribute values.

POST /inventory/v1/cloud-service/get

Request Example

CloudServiceRequest

cloud_service_id (string) Required

{
   "cloud_service_id": "cloud-svc-fea2b0d32141"
}

Response Example

CloudServiceInfo

cloud_service_id (string) Required
name (string) Required
state (string) Required
ip_addresses (string) Repeated Required
account (string) Required
instance_type (string) Required
instance_size (float) Required
cloud_service_type (string) Required
cloud_service_group (string) Required
provider (string) Required
data (Struct) Required
metadata (Struct) Required
reference (CloudServiceReference) Required
tags (Struct) Required
tag_keys (Struct) Required
collection_info (CollectionInfo) Required
region_code (string) Required
domain_id (string) Required
workspace_id (string) Required
project_id (string) Required
created_at (string) Required
updated_at (string) Required
deleted_at (string) Required

{
   "cloud_service_id": "cloud-svc-c00f38a173e1",
   "name": "cloud_service_test",
   "state": "ACTIVE",
   "account": "251340636361",
   "cloud_service_type": "Key",
   "cloud_service_group": "KMS",
   "provider": "aws",
   "data": {
       "alias_arn": null,
       "origin": "AWS_KMS",
       "cloudwatch": {
           "region_name": "ap-northeast-1",
           "namespace": "AWS/KMS",
           "dimensions": [
               {
                   "Value": "0drda5e1-c40f-45d7-a647-xxxxxxx",
                   "Name": "KeyId"
               }
           ]
       },
       "aws_account_id": "251340636361",
       "creation_date": "2020-07-09T09:39:03.097000+0000",
       "encryption_algorithms": [
           "SYMMETRIC_DEFAULT"
       ],
       "key_usage": "ENCRYPT_DECRYPT",
       "key_id": "0drda5e1-c40f-45d7-a647-xxxxxxx",
       "key_type_path": "defaultKeys",
       "key_rotated": false,
       "description": "Default master key that protects my Secrets Manager data when no other key is defined",
       "key_state": "Enabled",
       "customer_master_key_spec": "SYMMETRIC_DEFAULT",
       "enabled": true,
       "arn": "arn:aws:kms:ap-northeast-1:251340636361:key/0drda5e1-c40f-45d7-a647-xxxxxxx",
       "key_manager": "AWS"
   },
   "metadata": {
       "manual": {}
   },
   "reference": {
       "resource_id": "arn:aws:kms:ap-northeast-1:251340636361:key/0drda5e1-c40f-45d7-a647-xxxxxxx",
       "external_link": "https://console.aws.amazon.com/kms/home?region=ap-northeast-1#/kms/defaultKeys/0drda5e1-c40f-45d7-a647-xxxxxxx/"
   },
   "tags": {
       "a": "b"
   },
   "collection_info": {
       "service_account_id": "sa-abcd1234",
       "secret_id": "secret-abcd1234",
       "collector_id": "collector-abcd1234",
       "last_collected_at": "2022-06-22T06:38:48.989Z"
   },
   "ip_addresses": [],
   "region_code": "ap-northeast-1",
   "workspace_id": "workspace-58010aa2e451",
   "domain_id": "domain-58010aa2e451",
   "created_at": "2022-06-22T06:38:48.989Z",
   "updated_at": "2022-06-22T06:38:48.989Z",
   "launched_at": "2020-08-03T15:00:54.000Z"
}

list #

Gets a list of all CloudServices. You can use a query to get a filtered list of CloudServices.

POST /inventory/v1/cloud-service/list

Request Example

CloudServiceQuery

query (Query)
cloud_service_id (string)
name (string)
state (string)
ip_address (string)
account (string)
instance_type (string)
cloud_service_type (string)
cloud_service_group (string)
provider (string)
region_code (string)
workspace_id (string)
project_id (string)
project_group_id (string)

{
   "query": {
       "filter": [
           {
               "key": "cloud_service_type",
               "value": "Key",
               "operator": "eq"
           }
       ]
   }
}

Response Example

CloudServicesInfo

results (CloudServiceInfo) Repeated Required
total_count (int32) Required

{
   "results": [{
       "cloud_service_id": "cloud-svc-c00f38a173e1",
       "name": "cloud_service_test2",
       "state": "ACTIVE",
       "account": "251340636361",
       "cloud_service_type": "Key",
       "cloud_service_group": "KMS",
       "provider": "aws",
       "data": {
           "alias_arn": null,
           "origin": "AWS_KMS",
           "cloudwatch": {
               "region_name": "ap-northeast-1",
               "namespace": "AWS/KMS",
               "dimensions": [
                   {
                       "Value": "0drda5e1-c40f-45d7-a647-xxxxxxx",
                       "Name": "KeyId"
                   }
               ]
           },
           "aws_account_id": "251340636361",
           "creation_date": "2020-07-09T09:39:03.097000+0000",
           "encryption_algorithms": [
               "SYMMETRIC_DEFAULT"
           ],
           "key_usage": "ENCRYPT_DECRYPT",
           "key_id": "0drda5e1-c40f-45d7-a647-xxxxxxx",
           "key_type_path": "defaultKeys",
           "key_rotated": false,
           "description": "Default master key that protects my Secrets Manager data when no other key is defined",
           "key_state": "Enabled",
           "customer_master_key_spec": "SYMMETRIC_DEFAULT",
           "enabled": true,
           "arn": "arn:aws:kms:ap-northeast-1:251340636361:key/0drda5e1-c40f-45d7-a647-xxxxxxx",
           "key_manager": "AWS"
       },
       "metadata": {
           "manual": {}
       },
       "reference": {
           "resource_id": "arn:aws:kms:ap-northeast-1:251340636361:key/0drda5e1-c40f-45d7-a647-xxxxxxx",
           "external_link": "https://console.aws.amazon.com/kms/home?region=ap-northeast-1#/kms/defaultKeys/0drda5e1-c40f-45d7-a647-xxxxxxx/"
       },
       "tags": {
           "description": "spaceone"
       },
       "collection_info": {
            "service_account_id": "sa-abcd1234",
            "secret_id": "secret-abcd1234",
            "collector_id": "collector-abcd1234",
            "last_collected_at": "2022-06-22T06:38:48.989Z"
       },
       "ip_addresses": [
           "1.1.1.1",
           "2.2.2.2"
       ],
       "region_code": "ap-northeast-1",
       "workspace_id": "workspace-58010aa2e451",
       "domain_id": "domain-58010aa2e451",
       "created_at": "2022-06-22T06:38:48.989Z",
       "updated_at": "2022-06-22T06:38:48.989Z",
       "launched_at": "2020-08-03T15:00:54.000Z"
   }],
   "total_count": 1
}

export #

POST /inventory/v1/cloud-service/export

analyze #

POST /inventory/v1/cloud-service/analyze

stat #

POST /inventory/v1/cloud-service/stat

Message #

CloudServiceAnalyzeQuery #

query (AnalyzeQuery) Required

CloudServiceExportRequest #

options (ExportOption) Repeated Required
file_format (FileFormat)
file_name (string)
timezone (string)

CloudServiceInfo #

cloud_service_id (string) Required
name (string) Required
state (string) Required
ip_addresses (string) Repeated Required
account (string) Required
instance_type (string) Required
instance_size (float) Required
cloud_service_type (string) Required
cloud_service_group (string) Required
provider (string) Required
data (Struct) Required
metadata (Struct) Required
reference (CloudServiceReference) Required
tags (Struct) Required
tag_keys (Struct) Required
collection_info (CollectionInfo) Required
region_code (string) Required
domain_id (string) Required
workspace_id (string) Required
project_id (string) Required
created_at (string) Required
updated_at (string) Required
deleted_at (string) Required

CloudServiceQuery #

query (Query)
cloud_service_id (string)
name (string)
state (string)
ip_address (string)
account (string)
instance_type (string)
cloud_service_type (string)
cloud_service_group (string)
provider (string)
region_code (string)
workspace_id (string)
project_id (string)
project_group_id (string)

CloudServiceReference #

resource_id (string) Required
external_link (string) Required

CloudServiceRequest #

cloud_service_id (string) Required

CloudServiceStatQuery #

query (StatisticsQuery) Required

CloudServicesInfo #

results (CloudServiceInfo) Repeated Required
total_count (int32) Required

CollectionInfo #

service_account_id (string) Required
secret_id (string) Required
collector_id (string) Required
last_collected_at (string) Required

CreateServiceRequest #

cloud_service_type (string) Required
provider (string) Required
cloud_service_group (string) Required
data (Struct) Required
name (string)
account (string)
instance_type (string)
instance_size (float)
ip_addresses (string) Repeated
metadata (Struct)
reference (CloudServiceReference)
tags (Struct)
region_code (string)
project_id (string)

UpdateCloudServiceRequest #

cloud_service_id (string) Required
name (string)
account (string)
instance_type (string)
instance_size (float)
ip_addresses (string) Repeated
data (Struct)
metadata (Struct)
reference (CloudServiceReference)
tags (Struct)
region_code (string)
project_id (string)