ICU API 1.0

The Internal Call Unit (ICU) API enables you to manage your OUTSCALE account and access keys.

Throttling: To protect against overloads, the number of identical requests allowed in a given time period is limited.
Brute force: To protect against brute force attacks, the number of failed authentication attempts in a given time period is limited.

Endpoints

Name	Base URL
ap-northeast-1	https://icu.ap-northeast-1.outscale.com
cloudgouv-eu-west-1	https://icu.cloudgouv-eu-west-1.outscale.com
eu-west-2 (default)	https://icu.eu-west-2.outscale.com
us-east-2	https://icu.us-east-2.outscale.com
us-west-1	https://icu.us-west-1.outscale.com

Terms of service. Email: support@outscale.com. License: BSD 3 Clause.

Authentication Schemes

Access Key/Secret Key

The main way to authenticate your requests to this API is to use an access key and a secret key.
The mechanism behind this is based on AWS Signature Version 4, whose technical implementation details are described in Signature of API Requests.

In practice, the way to specify your access key and secret key depends on the tool or SDK you want to use to interact with the API.

For example, if you use OSC CLI:

1. You need to create an ~/.osc/config.json file to specify your access key, secret key, and the Region of your account.
2. You then specify the --profile option when executing OSC CLI commands.

For more information, see Installing and Configuring OSC CLI.

See the code samples in each section of this documentation for specific examples in different programming languages.
For more information about access keys, see About Access Keys.

Login/Password

For certain API actions, you can also use basic authentication with the login (email address) and password of your TINA account.
This is useful only in special circumstances, for example if you do not know your access key/secret key and want to retrieve them programmatically.
In most cases, however, you can use the Cockpit web interface to retrieve them.

For example, if you use OSC CLI:

1. You need to create an ~/.osc/config.json file to specify the Region of your account, but you leave the access key value and secret key value empty ("").
2. You then specify the --profile, --authentication-method, --login, and --password options when executing OSC CLI commands.

See the code samples in each section of this documentation for specific examples in different programming languages.

No Authentication

A few API actions do not require any authentication. They are indicated as such in this documentation.

Other Security Mechanisms

In parallel with the authentication schemes, you can add other security mechanisms to your OUTSCALE account, for example to restrict API requests by IP or other criteria.
For more information, see Managing Your API Accesses.

Access Keys

CreateAccessKey

POST /CreateAccessKey

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Creates an access key for your account. The new key is automatically set to ACTIVE.

For more information, see About Access Keys.
This AWS-compliant method corresponds to CreateAccessKey in the OUTSCALE API.

Request Parameters

Examples

# Example with access key/secret key authentication

osc-cli icu CreateAccessKey --profile "default"

# Example with login/password authentication

osc-cli icu CreateAccessKey --profile "default" \
  --AuthenticationMethod "password" \
  --Login "$OSC_EMAIL" \
  --Password "$OSC_PASSWORD"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

# Example with access key/secret key authentication

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.CreateAccessKey' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "AuthenticationMethod": "string",
    "Login": "string",
    "Password": "string"
  }'

# Example with login/password authentication

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --header 'x-amz-target: TinaIcuService.CreateAccessKey' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "AuthenticationMethod": "string",
    "Login": "string",
    "Password": "string"
  }'

Body (CreateAccessKeyRequest):

Body Parameter	Type	Description
AuthenticationMethod (required)	string	The method you choose for authentication (accesskey for authentication by access key and secret key, or password for authentication by login and password). When using OSC CLI, you do not need to specify the accesskey value as it is the default authentication method.
Login	string	The email address for your account. Required when using the login and password authentication method.
Password	string	The password for your account. Required when using the login and password authentication method.

Response Elements

Examples

200 Response

{
  "accessKey": {
    "accessKeyId": "string",
    "createDate": "string",
    "expirationDate": "string",
    "ownerId": "string",
    "secretAccessKey": "string",
    "status": "string",
    "touchDate": "string"
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (CreateAccessKeyResponse):

Response Element	Type	Description
accessKey	accessKey_0	Information about an access key.
accessKeyId	string	The ID of the access key.
createDate	string	The date and time of creation of the access key.
expirationDate	string	The expiration date of the access key.
ownerId	string	The account ID of the owner of the access key.
secretAccessKey	string	The secret access key that enables you to send requests.
status	string	The state of the access key (ACTIVE if the key is valid for API calls, or INACTIVE if not).
touchDate	string	The date and time of the last modification of the access key.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

DeleteAccessKey

POST /DeleteAccessKey

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Deletes the specified access key of your account.

This AWS-compliant method corresponds to DeleteAccessKey in the OUTSCALE API.

Request Parameters

Examples

# Example with access key/secret key authentication

osc-cli icu DeleteAccessKey --profile "default" \
  --AccessKeyId "string"

# Example with login/password authentication

osc-cli icu DeleteAccessKey --profile "default" \
  --AccessKeyId "string" \
  --AuthenticationMethod "password" \
  --Login "$OSC_EMAIL" \
  --Password "$OSC_PASSWORD"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

# Example with access key/secret key authentication

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.DeleteAccessKey' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "AccessKeyId": "string",
    "AuthenticationMethod": "string",
    "Login": "string",
    "Password": "string"
  }'

# Example with login/password authentication

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --header 'x-amz-target: TinaIcuService.DeleteAccessKey' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "AccessKeyId": "string",
    "AuthenticationMethod": "string",
    "Login": "string",
    "Password": "string"
  }'

Body (DeleteAccessKeyRequest):

Body Parameter	Type	Description
AccessKeyId (required)	string	The ID of the access key you want to delete.
AuthenticationMethod (required)	string	The method you choose for authentication (accesskey for authentication by access key and secret key, or password for authentication by login and password). When using OSC CLI, you do not need to specify the accesskey value as it is the default authentication method.
Login	string	The email address for your account. Required when using the login and password authentication method.
Password	string	The password for your account. Required when using the login and password authentication method.

Response Elements

Examples

200 Response

{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "Return": true
}

Response 200 (DeleteAccessKeyResponse):

Response Element	Type	Description
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.
Return	boolean	Always true when the request succeeds.

GetAccessKey

POST /GetAccessKey

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Lists information about the specified access key of your account.

Request Parameters

Examples

# Example with access key/secret key authentication

osc-cli icu GetAccessKey --profile "default" \
  --AccessKeyId "string"

# Example with login/password authentication

osc-cli icu GetAccessKey --profile "default" \
  --AccessKeyId "string" \
  --AuthenticationMethod "password" \
  --Login "$OSC_EMAIL" \
  --Password "$OSC_PASSWORD"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

# Example with access key/secret key authentication

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.GetAccessKey' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "AccessKeyId": "string",
    "AuthenticationMethod": "string",
    "Login": "string",
    "Password": "string"
  }'

# Example with login/password authentication

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --header 'x-amz-target: TinaIcuService.GetAccessKey' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "AccessKeyId": "string",
    "AuthenticationMethod": "string",
    "Login": "string",
    "Password": "string"
  }'

Body (GetAccessKeyRequest):

Body Parameter	Type	Description
AccessKeyId (required)	string	The ID of the access key.
AuthenticationMethod (required)	string	The method you choose for authentication (accesskey for authentication by access key and secret key, or password for authentication by login and password). When using OSC CLI, you do not need to specify the accesskey value as it is the default authentication method.
Login	string	The email address for your account. Required when using the login and password authentication method.
Password	string	The password for your account. Required when using the login and password authentication method.

Response Elements

Examples

200 Response

{
  "accessKey": {
    "accessKeyId": "string",
    "createDate": "string",
    "expirationDate": "string",
    "ownerId": "string",
    "status": "string",
    "touchDate": "string"
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (GetAccessKeyResponse):

Response Element	Type	Description
accessKey	accessKey_1	Information about an access key.
accessKeyId	string	The ID of the access key.
createDate	string	The date and time of creation of the access key.
expirationDate	string	The expiration date of the access key.
ownerId	string	The account ID of the owner of the access key.
status	string	The state of the access key (ACTIVE if the key is valid for API calls, or INACTIVE if not).
touchDate	string	The date and time of the last modification of the access key.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

ListAccessKeys

POST /ListAccessKeys

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Lists the access keys of your account.

This AWS-compliant method corresponds to ReadAccessKeys in the OUTSCALE API.

Request Parameters

Examples

# Example with access key/secret key authentication

osc-cli icu ListAccessKeys --profile "default" \
  --Marker "string" \
  --MaxItems 0

# Example with login/password authentication

osc-cli icu ListAccessKeys --profile "default" \
  --Marker "string" \
  --MaxItems 0 \
  --AuthenticationMethod "password" \
  --Login "$OSC_EMAIL" \
  --Password "$OSC_PASSWORD"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

# Example with access key/secret key authentication

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.ListAccessKeys' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "Marker": "string",
    "MaxItems": 0,
    "AuthenticationMethod": "string",
    "Login": "string",
    "Password": "string"
  }'

# Example with login/password authentication

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --header 'x-amz-target: TinaIcuService.ListAccessKeys' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "Marker": "string",
    "MaxItems": 0,
    "AuthenticationMethod": "string",
    "Login": "string",
    "Password": "string"
  }'

Body (ListAccessKeysRequest):

Body Parameter	Type	Description
Marker	string	The marker to request the next results page.
MaxItems	integer	The maximum number of items that can be returned in a single page (by default, 100).
AuthenticationMethod (required)	string	The method you choose for authentication (accesskey for authentication by access key and secret key, or password for authentication by login and password). When using OSC CLI, you do not need to specify the accesskey value as it is the default authentication method.
Login	string	The email address for your account. Required when using the login and password authentication method.
Password	string	The password for your account. Required when using the login and password authentication method.

Response Elements

Examples

200 Response

{
  "accessKeys": [
    {
      "accessKeyId": "string",
      "createDate": "string",
      "expirationDate": "string",
      "ownerId": "string",
      "status": "string",
      "touchDate": "string"
    }
  ],
  "IsTruncated": true,
  "Marker": "string",
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (ListAccessKeysResponse):

Response Element	Type	Description
accessKeys	[accessKey_1]	A list of access keys.
accessKeyId	string	The ID of the access key.
createDate	string	The date and time of creation of the access key.
expirationDate	string	The expiration date of the access key.
ownerId	string	The account ID of the owner of the access key.
status	string	The state of the access key (ACTIVE if the key is valid for API calls, or INACTIVE if not).
touchDate	string	The date and time of the last modification of the access key.
IsTruncated	boolean	If true, there are more items to return using the marker in a new request.
Marker	string	The marker to request the next results page.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

UpdateAccessKey

POST /UpdateAccessKey

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Modifies the status of the specified access key of your account.

This AWS-compliant method corresponds to UpdateAccessKey in the OUTSCALE API.

Request Parameters

Examples

# Example with access key/secret key authentication

osc-cli icu UpdateAccessKey --profile "default" \
  --AccessKeyId "string" \
  --Status "string"

# Example with login/password authentication

osc-cli icu UpdateAccessKey --profile "default" \
  --AccessKeyId "string" \
  --Status "string" \
  --AuthenticationMethod "password" \
  --Login "$OSC_EMAIL" \
  --Password "$OSC_PASSWORD"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

# Example with access key/secret key authentication

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.UpdateAccessKey' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "AccessKeyId": "string",
    "Status": "string",
    "AuthenticationMethod": "string",
    "Login": "string",
    "Password": "string"
  }'

# Example with login/password authentication

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --header 'x-amz-target: TinaIcuService.UpdateAccessKey' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "AccessKeyId": "string",
    "Status": "string",
    "AuthenticationMethod": "string",
    "Login": "string",
    "Password": "string"
  }'

Body (UpdateAccessKeyRequest):

Body Parameter	Type	Description
AccessKeyId (required)	string	The ID of the access key.
Status (required)	string	The new state for the access key (ACTIVE | INACTIVE).
AuthenticationMethod (required)	string	The method you choose for authentication (accesskey for authentication by access key and secret key, or password for authentication by login and password). When using OSC CLI, you do not need to specify the accesskey value as it is the default authentication method.
Login	string	The email address for your account. Required when using the login and password authentication method.
Password	string	The password for your account. Required when using the login and password authentication method.

Response Elements

Examples

200 Response

{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "Return": true
}

Response 200 (UpdateAccessKeyResponse):

Response Element	Type	Description
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.
Return	boolean	Always true when the request succeeds.

Accounts

AuthenticateAccount

POST /AuthenticateAccount

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Authenticates an account using the provided login information.

This AWS-compliant method corresponds to CheckAuthentication in the OUTSCALE API.

Request Parameters

Examples

osc-cli icu AuthenticateAccount --profile "default" \
  --Login "$OSC_EMAIL" \
  --Password "$OSC_PASSWORD"

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --header 'x-amz-target: TinaIcuService.AuthenticateAccount' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "Login": "string",
    "Password": "string"
  }'

Body (AuthenticateAccountRequest):

Body Parameter	Type	Description
Login (required)	string	The email address or personal identifier (Pid) for the account.
Password (required)	string	The password for the account.

Response Elements

Examples

200 Response

{
  "return": true
}

Response 200 (AuthenticateAccountResponse):

Response Element	Type	Description
return	boolean	Always true when the request succeeds.

CreateAccount

POST /CreateAccount

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Creates an OUTSCALE account.

[IMPORTANT]

• You need OUTSCALE credentials and the appropriate quotas to create an account via API. To get quotas, you can send an email to sales@outscale.com.
  
• If you want to pass a numeral value as a string instead of an integer, you must wrap your string in additional quotes (for example, '"92000"').
  
  For more information, see About Your Account.
  This AWS-compliant method corresponds to CreateAccount in the OUTSCALE API.

Request Parameters

Examples

osc-cli icu CreateAccount --profile "default" \
  --AccessKeys '[
      {
        "AccessKeyId": "string",
        "SecretAccessKey": "string"
      }
    ]' \
  --AccountPid "string" \
  --City "string" \
  --CompanyName "string" \
  --Country "string" \
  --CustomerId "string" \
  --Email "string" \
  --FirstName "string" \
  --JobTitle "string" \
  --LastName "string" \
  --MobileNumber "string" \
  --Password "string" \
  --PhoneNumber "string" \
  --Profile "string" \
  --State "string" \
  --VatNumber "string" \
  --ZipCode "string"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.CreateAccount' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "AccessKeys": [
      {
        "AccessKeyId": "string",
        "SecretAccessKey": "string"
      }
    ],
    "AccountPid": "string",
    "City": "string",
    "CompanyName": "string",
    "Country": "string",
    "CustomerId": "string",
    "Email": "string",
    "FirstName": "string",
    "JobTitle": "string",
    "LastName": "string",
    "MobileNumber": "string",
    "Password": "string",
    "PhoneNumber": "string",
    "Profile": "string",
    "State": "string",
    "VatNumber": "string",
    "ZipCode": "string"
  }'

Body (CreateAccountRequest):

Body Parameter	Type	Description
AccessKeys	[AccessKeysAccountCreation]	The access keys of your account.
AccessKeyId	string	The ID of the access key.
SecretAccessKey	string	The secret access key that enables you to send requests.
AccountPid	string	The PID of the account.
City (required)	string	The city of the account owner.
CompanyName (required)	string	The name of the company for the account.
Country (required)	string	The country of the account owner.
CustomerId	string	The ID of the customer. It must be 8 digits (by default, 12345678).
Email (required)	string	The email address for the account.
FirstName (required)	string	The first name of the account owner.
JobTitle	string	The job title of the account owner.
LastName (required)	string	The last name of the account owner.
MobileNumber	string	The mobile phone number of the account owner.
Password (required)	string	The password for the account.
PhoneNumber	string	The landline phone number of the account owner.
Profile	string	The profile for the account you want to create (always default).
State	string	The state of the account.
VatNumber	string	The value added tax (VAT) number for the account.
ZipCode (required)	string	The ZIP code of the city.

Response Elements

Examples

200 Response

{
  "Account": {
    "AccountPid": "string",
    "City": "string",
    "CompanyName": "string",
    "Country": "string",
    "CustomerId": "string",
    "Email": "string",
    "FirstName": "string",
    "JobTitle": "string",
    "LastName": "string",
    "MobileNumber": "string",
    "PhoneNumber": "string",
    "State": "string",
    "VatNumber": "string",
    "ZipCode": "string"
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (CreateAccountResponse):

Response Element	Type	Description
Account	Account	Information about the account.
AccountPid	string	The personal identifier (PID) of the account.
City	string	The city of the account owner.
CompanyName	string	The name of the company for the account.
Country	string	The country of the account owner.
CustomerId	string	The ID of the customer.
Email	string	The email address for the account.
FirstName	string	The first name of the account owner.
JobTitle	string	The job title of the account owner.
LastName	string	The last name of the account owner.
MobileNumber	string	The mobile phone number of the account owner.
PhoneNumber	string	The landline phone number of the account owner.
State	string	The state of the account owner.
VatNumber	string	The VAT number of the account.
ZipCode	string	The ZIP code of the city.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

GetAccount

POST /GetAccount

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Gets information about the account that sent the request.

This AWS-compliant method corresponds to ReadAccounts in the OUTSCALE API.

Request Parameters

Examples

osc-cli icu GetAccount --profile "default"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.GetAccount' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{}'

Body (GetAccountRequest):

Body Parameter	Type	Description

Response Elements

Examples

200 Response

{
  "Account": {
    "AccountPid": "string",
    "City": "string",
    "CompanyName": "string",
    "Country": "string",
    "CustomerId": "string",
    "Email": "string",
    "FirstName": "string",
    "JobTitle": "string",
    "LastName": "string",
    "MobileNumber": "string",
    "PhoneNumber": "string",
    "State": "string",
    "VatNumber": "string",
    "ZipCode": "string"
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (GetAccountResponse):

Response Element	Type	Description
Account	Account	Information about the account.
AccountPid	string	The personal identifier (PID) of the account.
City	string	The city of the account owner.
CompanyName	string	The name of the company for the account.
Country	string	The country of the account owner.
CustomerId	string	The ID of the customer.
Email	string	The email address for the account.
FirstName	string	The first name of the account owner.
JobTitle	string	The job title of the account owner.
LastName	string	The last name of the account owner.
MobileNumber	string	The mobile phone number of the account owner.
PhoneNumber	string	The landline phone number of the account owner.
State	string	The state of the account owner.
VatNumber	string	The VAT number of the account.
ZipCode	string	The ZIP code of the city.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

ReadConsumptionAccount

POST /ReadConsumptionAccount

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Displays information about the consumption of your account for each billable resource within the specified time period.

This AWS-compliant method corresponds to ReadConsumptionAccount in the OUTSCALE API.

Request Parameters

Examples

osc-cli icu ReadConsumptionAccount --profile "default" \
  --FromDate "string" \
  --ToDate "string"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.ReadConsumptionAccount' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "FromDate": "string",
    "ToDate": "string"
  }'

Body (ReadConsumptionAccountRequest):

Body Parameter	Type	Description
FromDate (required)	string	The beginning of the time period, in ISO 8601 format (for example, 2017-06-14). This value is included in the time period.
ToDate (required)	string	The end of the time period, in ISO 8601 format (for example, 2017-06-30). This value is excluded from the time period, and must be set to a later date than FromDate.

Response Elements

Examples

200 Response

{
  "Entries": [
    {
      "Category": "string",
      "FromDate": "string",
      "Operation": "string",
      "Service": "string",
      "Title": "string",
      "ToDate": "string",
      "Type": "string",
      "Value": 0.1,
      "Zone": "string"
    }
  ],
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (ReadConsumptionAccountResponse):

Response Element	Type	Description
Entries	[Entries_1]	Information about the resources consumed during the specified time period.
Category	string	The category of resource (for example, network).
FromDate	string	The beginning of the time period.
Operation	string	The API call that triggered the resource consumption (for example, RunInstances or CreateVolume).
Service	string	The service of the API call (TinaOS-FCU, TinaOS-LBU, TinaOS-DirectLink, TinaOS-OOS, or TinaOS-OSU).
Title	string	A description of the consumed resource.
ToDate	string	The end of the time period.
Type	string	The type of resource, depending on the API call.
Value	number (double)	The consumed amount for the resource. The unit depends on the resource type. For more information, see the Title element.
Zone	string	The Availability Zone (AZ) in which the resources were consumed. For cross-AZs resources, this may also be the Region name.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

UpdateAccount

POST /UpdateAccount

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Updates the account information for the account that sends the request.

This AWS-compliant method corresponds to UpdateAccount in the OUTSCALE API.

Request Parameters

Examples

osc-cli icu UpdateAccount --profile "default" \
  --City "string" \
  --CompanyName "string" \
  --Country "string" \
  --Email "string" \
  --FirstName "string" \
  --JobTitle "string" \
  --LastName "string" \
  --MobileNumber "string" \
  --Password "string" \
  --PhoneNumber "string" \
  --State "string" \
  --VatNumber "string" \
  --ZipCode "string"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.UpdateAccount' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "City": "string",
    "CompanyName": "string",
    "Country": "string",
    "Email": "string",
    "FirstName": "string",
    "JobTitle": "string",
    "LastName": "string",
    "MobileNumber": "string",
    "Password": "string",
    "PhoneNumber": "string",
    "State": "string",
    "VatNumber": "string",
    "ZipCode": "string"
  }'

Body (UpdateAccountRequest):

Body Parameter	Type	Description
City	string	The new city of the account owner.
CompanyName	string	The new name of the company for the account.
Country	string	The new country of the account owner.
Email	string	The new email address for the account.
FirstName	string	The new first name of the account owner.
JobTitle	string	The new job title of the account owner.
LastName	string	The new last name of the account owner.
MobileNumber	string	The new mobile phone number of the account owner.
Password	string	The new password for the account. Password strength is tested through heuristic algorithms. For more information, see the zxcvbn GitHub.
PhoneNumber	string	The new landline phone number of the account owner.
State	string	The new state of the account owner.
VatNumber	string	The new value added tax (VAT) number for the account.
ZipCode	string	The new ZIP code of the city.

Response Elements

Examples

200 Response

{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "Return": true
}

Response 200 (UpdateAccountResponse):

Response Element	Type	Description
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.
Return	boolean	Always true when the request succeeds.

Catalogs

ReadCatalog

POST /ReadCatalog

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Returns the price list of OUTSCALE services for the current Region.

This AWS-compliant method corresponds to ReadCatalog in the OUTSCALE API.

Request Parameters

Examples

osc-cli icu ReadCatalog --profile "default"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.ReadCatalog' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{}'

Body (ReadCatalogRequest):

Body Parameter	Type	Description

Response Elements

Examples

200 Response

{
  "Catalog": {
    "Attributes": [
      {
        "Key": "string",
        "Value": "string"
      }
    ],
    "Entries": [
      {
        "Attributes": {
          "Key": "string",
          "Value": "string"
        },
        "Key": "string",
        "Title": "string",
        "Value": "string"
      }
    ]
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (ReadCatalogResponse):

Response Element	Type	Description
Catalog	Catalog	Information about one or more catalogs of prices.
Attributes	[Attributes]	One or more catalog attributes (for example, currency).
Key	string	The key of the catalog attribute.
Value	string	The value of the catalog attribute.
Entries	[Entries_0]	One or more catalog entries.
Attributes	Attributes	One or more catalog attributes (for example, currency).
Key	string	The key of the catalog attribute.
Value	string	The value of the catalog attribute.
Key	string	The identifier of the catalog entry.
Title	string	The description of the catalog entry.
Value	string	The price of the catalog entry.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

ReadPublicCatalog

POST /ReadPublicCatalog

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Returns the price list of OUTSCALE products and services for the Region specified in the endpoint of the request. For more information, see About Regions and Subregions
This AWS-compliant method corresponds to ReadPublicCatalog in the OUTSCALE API.

Request Parameters

Examples

osc-cli icu ReadPublicCatalog --profile "default"

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --header 'x-amz-target: TinaIcuService.ReadPublicCatalog' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{}'

Body (ReadPublicCatalogRequest):

Body Parameter	Type	Description

Response Elements

Examples

200 Response

{
  "Catalog": {
    "Attributes": [
      {
        "Key": "string",
        "Value": "string"
      }
    ],
    "Entries": [
      {
        "Attributes": {
          "Key": "string",
          "Value": "string"
        },
        "Key": "string",
        "Title": "string",
        "Value": "string"
      }
    ]
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (ReadPublicCatalogResponse):

Response Element	Type	Description
Catalog	Catalog	Information about one or more catalogs of prices.
Attributes	[Attributes]	One or more catalog attributes (for example, currency).
Key	string	The key of the catalog attribute.
Value	string	The value of the catalog attribute.
Entries	[Entries_0]	One or more catalog entries.
Attributes	Attributes	One or more catalog attributes (for example, currency).
Key	string	The key of the catalog attribute.
Value	string	The value of the catalog attribute.
Key	string	The identifier of the catalog entry.
Title	string	The description of the catalog entry.
Value	string	The price of the catalog entry.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

ListenerRules

CreateListenerRule

POST /CreateListenerRule

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Creates a rule for traffic redirection for the specified listener.
Each rule must have either the HostPattern or PathPattern parameter specified. Rules are treated in priority order, from the highest value to the lowest value.
Once the rule is created, you need to register backend instances with it. For more information, see the RegisterInstancesWithListenerRule method.

For more information, see About Load Balancers.
This AWS-compliant method corresponds to CreateListenerRule in the OUTSCALE API.

Request Parameters

Examples

osc-cli icu CreateListenerRule --profile "default" \
  --Instances '[
      {
        "InstanceId": "string"
      }
    ]' \
  --ListenerDescription '{
      "LoadBalancerName": "string",
      "LoadBalancerPort": 0
    }' \
  --ListenerRuleDescription '{
      "HostPattern": "string",
      "PathPattern": "string",
      "Priority": 0,
      "RuleName": "string"
    }'

# You need Curl version 7.75 or later to use the --aws-sigv4 option

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.CreateListenerRule' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "Instances": [
      {
        "InstanceId": "string"
      }
    ],
    "ListenerDescription": {
      "LoadBalancerName": "string",
      "LoadBalancerPort": 0
    },
    "ListenerRuleDescription": {
      "HostPattern": "string",
      "PathPattern": "string",
      "Priority": 0,
      "RuleName": "string"
    }
  }'

Body (CreateListenerRuleRequest):

Body Parameter	Type	Description
Instances (required)	[Instances]	The list of backend instances to register to this rule.
InstanceId (required)	string	The ID of the backend instance.
ListenerDescription (required)	ListenerDescription	The description of the listener.
LoadBalancerName	string	The name of the load balancer to which the listener is attached.
LoadBalancerPort	integer	The port of load balancer on which the listener is listening.
ListenerRuleDescription (required)	ListenerRuleDescription_0	The description of the listener rule.
HostPattern	string	A host-name pattern for the rule, with a maximum length of 128 characters.This host-name pattern supports maximum three wildcards, and must not contain any special characters except -.?.
PathPattern	string	A path pattern for the rule, with a maximum length of 128 characters.This path pattern supports maximum three wildcards, and must not contain any special characters except _-.$/~"'@:+?.
Priority	integer	The priority level of the listener rule, between 1 and 19999 both included. Each rule must have a unique priority level. Otherwise, an error is returned.
RuleName	string	A human-readable name for the listener rule.

Response Elements

Examples

200 Response

{
  "ListenerRule": {
    "Instances": [
      {
        "InstanceId": "string"
      }
    ],
    "ListenerId": 0,
    "ListenerRuleDescription": {
      "Action": "string",
      "HostPattern": "string",
      "PathPattern": "string",
      "Priority": 0,
      "RuleId": 0,
      "RuleName": "string"
    }
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (CreateListenerRuleResponse):

Response Element	Type	Description
ListenerRule	ListenerRule	The description of the listener rule.
Instances	[Instances]	The list of backend instances to register to this rule.
InstanceId	string	The ID of the backend instance.
ListenerId	integer	The ID of the listener.
ListenerRuleDescription	ListenerRuleDescription_1	The description of the listener rule.
Action	string	The type of action for the rule (always forward).
HostPattern	string	A host-name pattern for the rule, with a maximum length of 128 characters. This host-name pattern supports maximum three wildcards, and must not contain any special characters except -.?.
PathPattern	string	A path pattern for the rule, with a maximum length of 128 characters. This path pattern supports maximum three wildcards, and must not contain any special characters except _-.$/~"'@:+?.
Priority	integer	The priority level of the listener rule, between 1 and 19999 both included. Each rule must have a unique priority level. Otherwise, an error is returned.
RuleId	integer	A unique identifier for the listener rule.
RuleName	string	A human-readable name for the listener rule.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

DeleteListenerRule

POST /DeleteListenerRule

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Deletes a listener rule.
The previously active rule is disabled after deletion.

This AWS-compliant method corresponds to DeleteListenerRule in the OUTSCALE API.

Request Parameters

Examples

osc-cli icu DeleteListenerRule --profile "default" \
  --RuleName "string"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.DeleteListenerRule' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "RuleName": "string"
  }'

Body (DeleteListenerRuleRequest):

Body Parameter	Type	Description
RuleName (required)	string	The name of the rule you want to delete.

Response Elements

Examples

200 Response

{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "Return": true
}

Response 200 (DeleteListenerRuleResponse):

Response Element	Type	Description
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.
Return	boolean	Always true when the request succeeds.

DeregisterInstancesFromListenerRule

POST /DeregisterInstancesFromListenerRule

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Removes the specified instances from the list of target backends on which the listener rule redirects traffic.

Request Parameters

Examples

osc-cli icu DeregisterInstancesFromListenerRule --profile "default" \
  --Instances '[
      {
        "InstanceId": "string"
      }
    ]' \
  --RuleName "string"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.DeregisterInstancesFromListenerRule' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "Instances": [
      {
        "InstanceId": "string"
      }
    ],
    "RuleName": "string"
  }'

Body (DeregisterInstancesFromListenerRuleRequest):

Body Parameter	Type	Description
Instances (required)	[Instances]	The list of backend instances to deregister from this rule.
InstanceId (required)	string	The ID of the backend instance.
RuleName (required)	string	The name of the listener rule.

Response Elements

Examples

200 Response

{
  "Instances": [
    {
      "InstanceId": "string"
    }
  ],
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (DeregisterInstancesFromListenerRuleResponse):

Response Element	Type	Description
Instances	[Instances]	The list of backend instances registered to this rule.
InstanceId	string	The ID of the backend instance.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

ReadListenerRules

POST /ReadListenerRules

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Describes one or more listener rules.
By default, this action returns the full list of listener rules for the account.

This AWS-compliant method corresponds to ReadListenerRules in the OUTSCALE API.

Request Parameters

Examples

osc-cli icu ReadListenerRules --profile "default" \
  --RuleNames '["string"]'

# You need Curl version 7.75 or later to use the --aws-sigv4 option

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.ReadListenerRules' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "RuleNames": ["string"]
  }'

Body (ReadListenerRulesRequest):

Body Parameter	Type	Description
RuleNames	[string]	The list of names of the rules to describe.

Response Elements

Examples

200 Response

{
  "ListenerRules": {
    "ListenerRule": {
      "Instances": [
        {
          "InstanceId": "string"
        }
      ],
      "ListenerId": 0,
      "ListenerRuleDescription": {
        "Action": "string",
        "HostPattern": "string",
        "PathPattern": "string",
        "Priority": 0,
        "RuleId": 0,
        "RuleName": "string"
      }
    }
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (ReadListenerRulesResponse):

Response Element	Type	Description
ListenerRules	ListenerRules	The list of listener rules.
ListenerRule	ListenerRule	The description of the listener rule.
Instances	[Instances]	The list of backend instances to register to this rule.
InstanceId	string	The ID of the backend instance.
ListenerId	integer	The ID of the listener.
ListenerRuleDescription	ListenerRuleDescription_1	The description of the listener rule.
Action	string	The type of action for the rule (always forward).
HostPattern	string	A host-name pattern for the rule, with a maximum length of 128 characters. This host-name pattern supports maximum three wildcards, and must not contain any special characters except -.?.
PathPattern	string	A path pattern for the rule, with a maximum length of 128 characters. This path pattern supports maximum three wildcards, and must not contain any special characters except _-.$/~"'@:+?.
Priority	integer	The priority level of the listener rule, between 1 and 19999 both included. Each rule must have a unique priority level. Otherwise, an error is returned.
RuleId	integer	A unique identifier for the listener rule.
RuleName	string	A human-readable name for the listener rule.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

RegisterInstancesWithListenerRule

POST /RegisterInstancesWithListenerRule

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Adds the specified instances to the list of target backends on which the listener rule redirects traffic.

Request Parameters

Examples

osc-cli icu RegisterInstancesWithListenerRule --profile "default" \
  --Instances '[
      {
        "InstanceId": "string"
      }
    ]' \
  --RuleName "string"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.RegisterInstancesWithListenerRule' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "Instances": [
      {
        "InstanceId": "string"
      }
    ],
    "RuleName": "string"
  }'

Body (RegisterInstancesWithListenerRuleRequest):

Body Parameter	Type	Description
Instances (required)	[Instances]	The list of backend instances to register to this rule.
InstanceId (required)	string	The ID of the backend instance.
RuleName (required)	string	The name of the listener rule.

Response Elements

Examples

200 Response

{
  "Instances": [
    {
      "InstanceId": "string"
    }
  ],
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (RegisterInstancesWithListenerRuleResponse):

Response Element	Type	Description
Instances	[Instances]	The list of backend instances registered to this rule.
InstanceId	string	The ID of the backend instance.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

UpdateListenerRule

POST /UpdateListenerRule

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Updates the pattern of the listener rule.
This call updates the pattern matching algorithm for incoming traffic.

This AWS-compliant method corresponds to UpdateListenerRule in the OUTSCALE API.

Request Parameters

Examples

osc-cli icu UpdateListenerRule --profile "default" \
  --Attribute "string" \
  --RuleName "string" \
  --Value "string"

# You need Curl version 7.75 or later to use the --aws-sigv4 option

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.UpdateListenerRule' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "Attribute": "string",
    "RuleName": "string",
    "Value": "string"
  }'

Body (UpdateListenerRuleRequest):

Body Parameter	Type	Description
Attribute (required)	string	The attribute of rule that needs to be modified (HostPattern | PathPattern).
RuleName (required)	string	The name of the listener rule.
Value (required)	string	The new value for the attribute.

Response Elements

Examples

200 Response

{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "Return": true
}

Response 200 (UpdateListenerRuleResponse):

Response Element	Type	Description
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.
Return	boolean	Always true when the request succeeds.

Quotas

ReadQuotas

POST /ReadQuotas

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Describes one or more of your quotas.
You can use the QuotaName.N parameter to filter the name of one or more quotas.
You can also use the Filter.N parameter to filter the described quotas on the following properties:

• reference: The reference of the quota.
  
• quota.display-name: The display name of the quota.
  
• quota.group-name: The group name of the quota.

For more information, see About Your Account.
This AWS-compliant method corresponds to ReadQuotas in the OUTSCALE API.

Request Parameters

Examples

osc-cli icu ReadQuotas --profile "default" \
  --Filters '[
      {
        "Name": "string",
        "Value": ["string"]
      }
    ]' \
  --MaxResults 0 \
  --NextToken "string" \
  --QuotaNames '["string"]'

# You need Curl version 7.75 or later to use the --aws-sigv4 option

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --user $OSC_ACCESS_KEY:$OSC_SECRET_KEY \
  --aws-sigv4 'aws:amz' \
  --header 'x-amz-target: TinaIcuService.ReadQuotas' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "Filters": [
      {
        "Name": "string",
        "Value": ["string"]
      }
    ],
    "MaxResults": 0,
    "NextToken": "string",
    "QuotaNames": ["string"]
  }'

Body (ReadQuotasRequest):

Body Parameter	Type	Description
Filters	[Filters]	One or more filters.
Name	string	The name of the filter.
Value	[string]	One or more filter values.
MaxResults	integer	The maximum number of items that can be returned in a single page (by default, 100).
NextToken	string	The token to request the next results page.
QuotaNames	[string]	One or more names of quotas.

Response Elements

Examples

200 Response

{
  "NextToken": "string",
  "ReferenceQuota": [
    {
      "Quotas": [
        {
          "Description": "string",
          "DisplayName": "string",
          "GroupName": "string",
          "MaxQuotaValue": 0,
          "Name": "string",
          "OwnerId": "string",
          "UsedQuotaValue": 0
        }
      ],
      "Reference": "string"
    }
  ],
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Response 200 (ReadQuotasResponse):

Response Element	Type	Description
NextToken	string	The token to request the next results page. If the value is null, there are no results left to be returned.
ReferenceQuota	[ReferenceQuota]	One or more reference quotas.
Quotas	[Quotas]	One or more quotas associated with the account.
Description	string	The description of the quota.
DisplayName	string	The display name of the quota.
GroupName	string	The group name the quota belongs to.
MaxQuotaValue	integer	The maximum value of the quota for the account (if there is no limit, 0).
Name	string	The unique name of the quota.
OwnerId	string	The account ID of owner of the quota.
UsedQuotaValue	integer	The limit value currently used by the account.
Reference	string	The resource ID if it is a resource-specific quota, global if it is not.
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.

Signatures

CheckSignature

POST /CheckSignature

[WARNING]
The Internal Call Unit (ICU) API is reaching its end of life.

End of Support and Maintenance (EOSM): December 31, 2024
After this date, the API is no longer fixed nor supported.
You can still use the product at your own risk. The SLA ceases to have effect, except for its guarantee of Sustainability which is effective until the EOL.

End of Life (EOL): January 31, 2025
After this date, the API will no longer be available for use.
You can still use your previously created resources via the OUTSCALE API only.

For more information, see the FAQ related to the ICU API end of life.

OUTSCALE recommends to use as of now the OUTSCALE API which provides the equivalent methods. For more information, see the Compatibility Matrix.

Validates the authenticity of the signature used in a request.
3DS OUTSCALE automatically generates a unique signature for every request you send. This signature is generated using the SecretKey, Region, ServiceName, StringToSign and AmzDate parameters, and is unique for the access key and for the request.

Request Parameters

Examples

osc-cli icu CheckSignature --profile "default" \
  --AccessKeyId "string" \
  --AmzDate "string" \
  --Region "string" \
  --ServiceName "string" \
  --Signature "string" \
  --StringToSign "string"

curl -X POST https://icu.$OSC_REGION.outscale.com \
  --header 'x-amz-target: TinaIcuService.CheckSignature' \
  --header 'Content-Type: application/x-amz-json-1.1' \
  --data '{
    "AccessKeyId": "string",
    "AmzDate": "string",
    "Region": "string",
    "ServiceName": "string",
    "Signature": "string",
    "StringToSign": "string"
  }'

Body (CheckSignatureRequest):

Body Parameter	Type	Description
AccessKeyId (required)	string	The ID of the access key used in the request, corresponding to the secret key used to generate the signature.
AmzDate (required)	string	The date of the request, in ISO 8601 format (for example, 20170630).
Region (required)	string	The Region to which you sent the request.
ServiceName (required)	string	The API service name for which you sent the request.
Signature (required)	string	The signature to validate.
StringToSign (required)	string	The string to sign, generated from the request body and headers.

Response Elements

Examples

200 Response

{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "Return": true
}

Response 200 (CheckSignatureResponse):

Response Element	Type	Description
ResponseMetadata	ResponseMetadata	Information about the response.
RequestId	string	The ID of the request.
Return	boolean	Always true when the request succeeds.

Schemas

accessKey_0

Information about an access key.

Property	Type	Description
accessKeyId	string	The ID of the access key.
createDate	string	The date and time of creation of the access key.
expirationDate	string	The expiration date of the access key.
ownerId	string	The account ID of the owner of the access key.
secretAccessKey	string	The secret access key that enables you to send requests.
status	string	The state of the access key (ACTIVE if the key is valid for API calls, or INACTIVE if not).
touchDate	string	The date and time of the last modification of the access key.

Schema

{
  "accessKeyId": "string",
  "createDate": "string",
  "expirationDate": "string",
  "ownerId": "string",
  "secretAccessKey": "string",
  "status": "string",
  "touchDate": "string"
}

accessKey_1

Information about an access key.

Property	Type	Description
accessKeyId	string	The ID of the access key.
createDate	string	The date and time of creation of the access key.
expirationDate	string	The expiration date of the access key.
ownerId	string	The account ID of the owner of the access key.
status	string	The state of the access key (ACTIVE if the key is valid for API calls, or INACTIVE if not).
touchDate	string	The date and time of the last modification of the access key.

Schema

{
  "accessKeyId": "string",
  "createDate": "string",
  "expirationDate": "string",
  "ownerId": "string",
  "status": "string",
  "touchDate": "string"
}

AccessKeyCreated

Information about the created access key.

Property	Type	Description
accessKeyId	string	The ID of the access key.
createDate	string	The date and time of creation of the access key.
expirationDate	string	The expiration date of the access key.
ownerId	string	The account ID of the owner of the access key.
status	string	The state of the access key (ACTIVE if the key is valid for API calls, or INACTIVE if not).
touchDate	string	The date and time of the last modification of the access key.

Schema

{
  "accessKeyId": "string",
  "createDate": "string",
  "expirationDate": "string",
  "ownerId": "string",
  "status": "string",
  "touchDate": "string"
}

AccessKeysAccountCreation

The access keys for the account.

Property	Type	Description
AccessKeyId	string	The ID of the access key.
SecretAccessKey	string	The secret access key that enables you to send requests.

Schema

{
  "AccessKeyId": "string",
  "SecretAccessKey": "string"
}

Account

Information about the account.

Property	Type	Description
AccountPid	string	The personal identifier (PID) of the account.
City	string	The city of the account owner.
CompanyName	string	The name of the company for the account.
Country	string	The country of the account owner.
CustomerId	string	The ID of the customer.
Email	string	The email address for the account.
FirstName	string	The first name of the account owner.
JobTitle	string	The job title of the account owner.
LastName	string	The last name of the account owner.
MobileNumber	string	The mobile phone number of the account owner.
PhoneNumber	string	The landline phone number of the account owner.
State	string	The state of the account owner.
VatNumber	string	The VAT number of the account.
ZipCode	string	The ZIP code of the city.

Schema

{
  "AccountPid": "string",
  "City": "string",
  "CompanyName": "string",
  "Country": "string",
  "CustomerId": "string",
  "Email": "string",
  "FirstName": "string",
  "JobTitle": "string",
  "LastName": "string",
  "MobileNumber": "string",
  "PhoneNumber": "string",
  "State": "string",
  "VatNumber": "string",
  "ZipCode": "string"
}

Attributes

One or more catalog attributes (for example, currency).

Property	Type	Description
Key	string	The key of the catalog attribute.
Value	string	The value of the catalog attribute.

Schema

{
  "Key": "string",
  "Value": "string"
}

AuthenticateAccountRequest

Property	Type	Description
Login	string	The email address or personal identifier (Pid) for the account.
Password	string	The password for the account.

Schema

{
  "Login": "string",
  "Password": "string"
}

AuthenticateAccountResponse

Property	Type	Description
return	boolean	Always true when the request succeeds.

Schema

{
  "return": true
}

Catalog

Information about one or more catalogs of prices.

Property	Type	Description
Attributes	[Attributes]	One or more catalog attributes (for example, currency).
Entries	[Entries_0]	One or more catalog entries.

Schema

{
  "Attributes": [
    {
      "Key": "string",
      "Value": "string"
    }
  ],
  "Entries": [
    {
      "Attributes": {
        "Key": "string",
        "Value": "string"
      },
      "Key": "string",
      "Title": "string",
      "Value": "string"
    }
  ]
}

CheckSignatureRequest

Property	Type	Description
AccessKeyId	string	The ID of the access key used in the request, corresponding to the secret key used to generate the signature.
AmzDate	string	The date of the request, in ISO 8601 format (for example, 20170630).
Region	string	The Region to which you sent the request.
ServiceName	string	The API service name for which you sent the request.
Signature	string	The signature to validate.
StringToSign	string	The string to sign, generated from the request body and headers.

Schema

{
  "AccessKeyId": "string",
  "AmzDate": "string",
  "Region": "string",
  "ServiceName": "string",
  "Signature": "string",
  "StringToSign": "string"
}

CheckSignatureResponse

Property	Type	Description
ResponseMetadata	ResponseMetadata	Information about the response.
Return	boolean	Always true when the request succeeds.

Schema

{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "Return": true
}

CreateAccessKeyRequest

Property	Type	Description
AuthenticationMethod	string	The method you choose for authentication (accesskey for authentication by access key and secret key, or password for authentication by login and password). When using OSC CLI, you do not need to specify the accesskey value as it is the default authentication method.
Login	string	The email address for your account. Required when using the login and password authentication method.
Password	string	The password for your account. Required when using the login and password authentication method.

Schema

{
  "AuthenticationMethod": "string",
  "Login": "string",
  "Password": "string"
}

CreateAccessKeyResponse

Property	Type	Description
accessKey	accessKey_0	Information about an access key.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "accessKey": {
    "accessKeyId": "string",
    "createDate": "string",
    "expirationDate": "string",
    "ownerId": "string",
    "secretAccessKey": "string",
    "status": "string",
    "touchDate": "string"
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

CreateAccountRequest

Property	Type	Description
AccessKeys	[AccessKeysAccountCreation]	The access keys of your account.
AccountPid	string	The PID of the account.
City	string	The city of the account owner.
CompanyName	string	The name of the company for the account.
Country	string	The country of the account owner.
CustomerId	string	The ID of the customer. It must be 8 digits (by default, 12345678).
Email	string	The email address for the account.
FirstName	string	The first name of the account owner.
JobTitle	string	The job title of the account owner.
LastName	string	The last name of the account owner.
MobileNumber	string	The mobile phone number of the account owner.
Password	string	The password for the account.
PhoneNumber	string	The landline phone number of the account owner.
Profile	string	The profile for the account you want to create (always default).
State	string	The state of the account.
VatNumber	string	The value added tax (VAT) number for the account.
ZipCode	string	The ZIP code of the city.

Schema

{
  "AccessKeys": [
    {
      "AccessKeyId": "string",
      "SecretAccessKey": "string"
    }
  ],
  "AccountPid": "string",
  "City": "string",
  "CompanyName": "string",
  "Country": "string",
  "CustomerId": "string",
  "Email": "string",
  "FirstName": "string",
  "JobTitle": "string",
  "LastName": "string",
  "MobileNumber": "string",
  "Password": "string",
  "PhoneNumber": "string",
  "Profile": "string",
  "State": "string",
  "VatNumber": "string",
  "ZipCode": "string"
}

CreateAccountResponse

Property	Type	Description
Account	Account	Information about the account.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "Account": {
    "AccountPid": "string",
    "City": "string",
    "CompanyName": "string",
    "Country": "string",
    "CustomerId": "string",
    "Email": "string",
    "FirstName": "string",
    "JobTitle": "string",
    "LastName": "string",
    "MobileNumber": "string",
    "PhoneNumber": "string",
    "State": "string",
    "VatNumber": "string",
    "ZipCode": "string"
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

CreateListenerRuleRequest

Property	Type	Description
Instances	[Instances]	The list of backend instances to register to this rule.
ListenerDescription	ListenerDescription	The description of the listener.
ListenerRuleDescription	ListenerRuleDescription_0	The description of the listener rule.

Schema

{
  "Instances": [
    {
      "InstanceId": "string"
    }
  ],
  "ListenerDescription": {
    "LoadBalancerName": "string",
    "LoadBalancerPort": 0
  },
  "ListenerRuleDescription": {
    "HostPattern": "string",
    "PathPattern": "string",
    "Priority": 0,
    "RuleName": "string"
  }
}

CreateListenerRuleResponse

Property	Type	Description
ListenerRule	ListenerRule	The description of the listener rule.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "ListenerRule": {
    "Instances": [
      {
        "InstanceId": "string"
      }
    ],
    "ListenerId": 0,
    "ListenerRuleDescription": {
      "Action": "string",
      "HostPattern": "string",
      "PathPattern": "string",
      "Priority": 0,
      "RuleId": 0,
      "RuleName": "string"
    }
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

DeleteAccessKeyRequest

Property	Type	Description
AccessKeyId	string	The ID of the access key you want to delete.
AuthenticationMethod	string	The method you choose for authentication (accesskey for authentication by access key and secret key, or password for authentication by login and password). When using OSC CLI, you do not need to specify the accesskey value as it is the default authentication method.
Login	string	The email address for your account. Required when using the login and password authentication method.
Password	string	The password for your account. Required when using the login and password authentication method.

Schema

{
  "AccessKeyId": "string",
  "AuthenticationMethod": "string",
  "Login": "string",
  "Password": "string"
}

DeleteAccessKeyResponse

Property	Type	Description
ResponseMetadata	ResponseMetadata	Information about the response.
Return	boolean	Always true when the request succeeds.

Schema

{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "Return": true
}

DeleteListenerRuleRequest

Property	Type	Description
RuleName	string	The name of the rule you want to delete.

Schema

{
  "RuleName": "string"
}

DeleteListenerRuleResponse

Property	Type	Description
ResponseMetadata	ResponseMetadata	Information about the response.
Return	boolean	Always true when the request succeeds.

Schema

{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "Return": true
}

DeregisterInstancesFromListenerRuleRequest

Property	Type	Description
Instances	[Instances]	The list of backend instances to deregister from this rule.
RuleName	string	The name of the listener rule.

Schema

{
  "Instances": [
    {
      "InstanceId": "string"
    }
  ],
  "RuleName": "string"
}

DeregisterInstancesFromListenerRuleResponse

Property	Type	Description
Instances	[Instances]	The list of backend instances registered to this rule.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "Instances": [
    {
      "InstanceId": "string"
    }
  ],
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Entries_0

One or more catalog entries.

Property	Type	Description
Attributes	Attributes	One or more catalog attributes (for example, currency).
Key	string	The identifier of the catalog entry.
Title	string	The description of the catalog entry.
Value	string	The price of the catalog entry.

Schema

{
  "Attributes": {
    "Key": "string",
    "Value": "string"
  },
  "Key": "string",
  "Title": "string",
  "Value": "string"
}

Entries_1

Information about the resources consumed during the specified time period.

Property	Type	Description
Category	string	The category of resource (for example, network).
FromDate	string	The beginning of the time period.
Operation	string	The API call that triggered the resource consumption (for example, RunInstances or CreateVolume).
Service	string	The service of the API call (TinaOS-FCU, TinaOS-LBU, TinaOS-DirectLink, TinaOS-OOS, or TinaOS-OSU).
Title	string	A description of the consumed resource.
ToDate	string	The end of the time period.
Type	string	The type of resource, depending on the API call.
Value	number (double)	The consumed amount for the resource. The unit depends on the resource type. For more information, see the Title element.
Zone	string	The Availability Zone (AZ) in which the resources were consumed. For cross-AZs resources, this may also be the Region name.

Schema

{
  "Category": "string",
  "FromDate": "string",
  "Operation": "string",
  "Service": "string",
  "Title": "string",
  "ToDate": "string",
  "Type": "string",
  "Value": 0.1,
  "Zone": "string"
}

Filters

One or more filters.

Property	Type	Description
Name	string	The name of the filter.
Value	[string]	One or more filter values.

Schema

{
  "Name": "string",
  "Value": [
    "string"
  ]
}

GetAccessKeyRequest

Property	Type	Description
AccessKeyId	string	The ID of the access key.
AuthenticationMethod	string	The method you choose for authentication (accesskey for authentication by access key and secret key, or password for authentication by login and password). When using OSC CLI, you do not need to specify the accesskey value as it is the default authentication method.
Login	string	The email address for your account. Required when using the login and password authentication method.
Password	string	The password for your account. Required when using the login and password authentication method.

Schema

{
  "AccessKeyId": "string",
  "AuthenticationMethod": "string",
  "Login": "string",
  "Password": "string"
}

GetAccessKeyResponse

Property	Type	Description
accessKey	accessKey_1	Information about an access key.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "accessKey": {
    "accessKeyId": "string",
    "createDate": "string",
    "expirationDate": "string",
    "ownerId": "string",
    "status": "string",
    "touchDate": "string"
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

GetAccountRequest

GetAccountResponse

Property	Type	Description
Account	Account	Information about the account.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "Account": {
    "AccountPid": "string",
    "City": "string",
    "CompanyName": "string",
    "Country": "string",
    "CustomerId": "string",
    "Email": "string",
    "FirstName": "string",
    "JobTitle": "string",
    "LastName": "string",
    "MobileNumber": "string",
    "PhoneNumber": "string",
    "State": "string",
    "VatNumber": "string",
    "ZipCode": "string"
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

Instances

The list of backend instances to register to this rule.

Property	Type	Description
InstanceId	string	The ID of the backend instance.

Schema

{
  "InstanceId": "string"
}

ListAccessKeysRequest

Property	Type	Description
Marker	string	The marker to request the next results page.
MaxItems	integer	The maximum number of items that can be returned in a single page (by default, 100).
AuthenticationMethod	string	The method you choose for authentication (accesskey for authentication by access key and secret key, or password for authentication by login and password). When using OSC CLI, you do not need to specify the accesskey value as it is the default authentication method.
Login	string	The email address for your account. Required when using the login and password authentication method.
Password	string	The password for your account. Required when using the login and password authentication method.

Schema

{
  "Marker": "string",
  "MaxItems": 0,
  "AuthenticationMethod": "string",
  "Login": "string",
  "Password": "string"
}

ListAccessKeysResponse

Property	Type	Description
accessKeys	[accessKey_1]	A list of access keys.
IsTruncated	boolean	If true, there are more items to return using the marker in a new request.
Marker	string	The marker to request the next results page.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "accessKeys": [
    {
      "accessKeyId": "string",
      "createDate": "string",
      "expirationDate": "string",
      "ownerId": "string",
      "status": "string",
      "touchDate": "string"
    }
  ],
  "IsTruncated": true,
  "Marker": "string",
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

ListenerDescription

The description of the listener.

Property	Type	Description
LoadBalancerName	string	The name of the load balancer to which the listener is attached.
LoadBalancerPort	integer	The port of load balancer on which the listener is listening.

Schema

{
  "LoadBalancerName": "string",
  "LoadBalancerPort": 0
}

ListenerRule

The description of the listener rule.

Property	Type	Description
Instances	[Instances]	The list of backend instances to register to this rule.
ListenerId	integer	The ID of the listener.
ListenerRuleDescription	ListenerRuleDescription_1	The description of the listener rule.

Schema

{
  "Instances": [
    {
      "InstanceId": "string"
    }
  ],
  "ListenerId": 0,
  "ListenerRuleDescription": {
    "Action": "string",
    "HostPattern": "string",
    "PathPattern": "string",
    "Priority": 0,
    "RuleId": 0,
    "RuleName": "string"
  }
}

ListenerRuleDescription_0

The description of the listener rule.

Property	Type	Description
HostPattern	string	A host-name pattern for the rule, with a maximum length of 128 characters. This host-name pattern supports maximum three wildcards, and must not contain any special characters except -.?.
PathPattern	string	A path pattern for the rule, with a maximum length of 128 characters. This path pattern supports maximum three wildcards, and must not contain any special characters except _-.$/~"'@:+?.
Priority	integer	The priority level of the listener rule, between 1 and 19999 both included. Each rule must have a unique priority level. Otherwise, an error is returned.
RuleName	string	A human-readable name for the listener rule.

Schema

{
  "HostPattern": "string",
  "PathPattern": "string",
  "Priority": 0,
  "RuleName": "string"
}

ListenerRuleDescription_1

The description of the listener rule.

Property	Type	Description
Action	string	The type of action for the rule (always forward).
HostPattern	string	A host-name pattern for the rule, with a maximum length of 128 characters. This host-name pattern supports maximum three wildcards, and must not contain any special characters except -.?.
PathPattern	string	A path pattern for the rule, with a maximum length of 128 characters. This path pattern supports maximum three wildcards, and must not contain any special characters except _-.$/~"'@:+?.
Priority	integer	The priority level of the listener rule, between 1 and 19999 both included. Each rule must have a unique priority level. Otherwise, an error is returned.
RuleId	integer	A unique identifier for the listener rule.
RuleName	string	A human-readable name for the listener rule.

Schema

{
  "Action": "string",
  "HostPattern": "string",
  "PathPattern": "string",
  "Priority": 0,
  "RuleId": 0,
  "RuleName": "string"
}

ListenerRules

The list of listener rules.

Property	Type	Description
ListenerRule	ListenerRule	The description of the listener rule.

Schema

{
  "ListenerRule": {
    "Instances": [
      {
        "InstanceId": "string"
      }
    ],
    "ListenerId": 0,
    "ListenerRuleDescription": {
      "Action": "string",
      "HostPattern": "string",
      "PathPattern": "string",
      "Priority": 0,
      "RuleId": 0,
      "RuleName": "string"
    }
  }
}

Quotas

One or more quotas associated with the account.

Property	Type	Description
Description	string	The description of the quota.
DisplayName	string	The display name of the quota.
GroupName	string	The group name the quota belongs to.
MaxQuotaValue	integer	The maximum value of the quota for the account (if there is no limit, 0).
Name	string	The unique name of the quota.
OwnerId	string	The account ID of owner of the quota.
UsedQuotaValue	integer	The limit value currently used by the account.

Schema

{
  "Description": "string",
  "DisplayName": "string",
  "GroupName": "string",
  "MaxQuotaValue": 0,
  "Name": "string",
  "OwnerId": "string",
  "UsedQuotaValue": 0
}

ReadCatalogRequest

ReadCatalogResponse

Property	Type	Description
Catalog	Catalog	Information about one or more catalogs of prices.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "Catalog": {
    "Attributes": [
      {
        "Key": "string",
        "Value": "string"
      }
    ],
    "Entries": [
      {
        "Attributes": {
          "Key": "string",
          "Value": "string"
        },
        "Key": "string",
        "Title": "string",
        "Value": "string"
      }
    ]
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

ReadConsumptionAccountRequest

Property	Type	Description
FromDate	string	The beginning of the time period, in ISO 8601 format (for example, 2017-06-14). This value is included in the time period.
ToDate	string	The end of the time period, in ISO 8601 format (for example, 2017-06-30). This value is excluded from the time period, and must be set to a later date than FromDate.

Schema

{
  "FromDate": "string",
  "ToDate": "string"
}

ReadConsumptionAccountResponse

Property	Type	Description
Entries	[Entries_1]	Information about the resources consumed during the specified time period.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "Entries": [
    {
      "Category": "string",
      "FromDate": "string",
      "Operation": "string",
      "Service": "string",
      "Title": "string",
      "ToDate": "string",
      "Type": "string",
      "Value": 0.1,
      "Zone": "string"
    }
  ],
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

ReadListenerRulesRequest

Property	Type	Description
RuleNames	[string]	The list of names of the rules to describe.

Schema

{
  "RuleNames": [
    "string"
  ]
}

ReadListenerRulesResponse

Property	Type	Description
ListenerRules	ListenerRules	The list of listener rules.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "ListenerRules": {
    "ListenerRule": {
      "Instances": [
        {
          "InstanceId": "string"
        }
      ],
      "ListenerId": 0,
      "ListenerRuleDescription": {
        "Action": "string",
        "HostPattern": "string",
        "PathPattern": "string",
        "Priority": 0,
        "RuleId": 0,
        "RuleName": "string"
      }
    }
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

ReadPublicCatalogRequest

ReadPublicCatalogResponse

Property	Type	Description
Catalog	Catalog	Information about one or more catalogs of prices.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "Catalog": {
    "Attributes": [
      {
        "Key": "string",
        "Value": "string"
      }
    ],
    "Entries": [
      {
        "Attributes": {
          "Key": "string",
          "Value": "string"
        },
        "Key": "string",
        "Title": "string",
        "Value": "string"
      }
    ]
  },
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

ReadQuotasRequest

Property	Type	Description
Filters	[Filters]	One or more filters.
MaxResults	integer	The maximum number of items that can be returned in a single page (by default, 100).
NextToken	string	The token to request the next results page.
QuotaNames	[string]	One or more names of quotas.

Schema

{
  "Filters": [
    {
      "Name": "string",
      "Value": [
        "string"
      ]
    }
  ],
  "MaxResults": 0,
  "NextToken": "string",
  "QuotaNames": [
    "string"
  ]
}

ReadQuotasResponse

Property	Type	Description
NextToken	string	The token to request the next results page. If the value is null, there are no results left to be returned.
ReferenceQuota	[ReferenceQuota]	One or more reference quotas.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "NextToken": "string",
  "ReferenceQuota": [
    {
      "Quotas": [
        {
          "Description": "string",
          "DisplayName": "string",
          "GroupName": "string",
          "MaxQuotaValue": 0,
          "Name": "string",
          "OwnerId": "string",
          "UsedQuotaValue": 0
        }
      ],
      "Reference": "string"
    }
  ],
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

ReferenceQuota

One or more reference quotas.

Property	Type	Description
Quotas	[Quotas]	One or more quotas associated with the account.
Reference	string	The resource ID if it is a resource-specific quota, global if it is not.

Schema

{
  "Quotas": [
    {
      "Description": "string",
      "DisplayName": "string",
      "GroupName": "string",
      "MaxQuotaValue": 0,
      "Name": "string",
      "OwnerId": "string",
      "UsedQuotaValue": 0
    }
  ],
  "Reference": "string"
}

RegisterInstancesWithListenerRuleRequest

Property	Type	Description
Instances	[Instances]	The list of backend instances to register to this rule.
RuleName	string	The name of the listener rule.

Schema

{
  "Instances": [
    {
      "InstanceId": "string"
    }
  ],
  "RuleName": "string"
}

RegisterInstancesWithListenerRuleResponse

Property	Type	Description
Instances	[Instances]	The list of backend instances registered to this rule.
ResponseMetadata	ResponseMetadata	Information about the response.

Schema

{
  "Instances": [
    {
      "InstanceId": "string"
    }
  ],
  "ResponseMetadata": {
    "RequestId": "string"
  }
}

ResponseMetadata

Information about the response.

Property	Type	Description
RequestId	string	The ID of the request.

Schema

{
  "RequestId": "string"
}

UpdateAccessKeyRequest

Property	Type	Description
AccessKeyId	string	The ID of the access key.
Status	string	The new state for the access key (ACTIVE | INACTIVE).
AuthenticationMethod	string	The method you choose for authentication (accesskey for authentication by access key and secret key, or password for authentication by login and password). When using OSC CLI, you do not need to specify the accesskey value as it is the default authentication method.
Login	string	The email address for your account. Required when using the login and password authentication method.
Password	string	The password for your account. Required when using the login and password authentication method.

Schema

{
  "AccessKeyId": "string",
  "Status": "string",
  "AuthenticationMethod": "string",
  "Login": "string",
  "Password": "string"
}

UpdateAccessKeyResponse

Property	Type	Description
ResponseMetadata	ResponseMetadata	Information about the response.
Return	boolean	Always true when the request succeeds.

Schema

{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "Return": true
}

UpdateAccountRequest

Property	Type	Description
City	string	The new city of the account owner.
CompanyName	string	The new name of the company for the account.
Country	string	The new country of the account owner.
Email	string	The new email address for the account.
FirstName	string	The new first name of the account owner.
JobTitle	string	The new job title of the account owner.
LastName	string	The new last name of the account owner.
MobileNumber	string	The new mobile phone number of the account owner.
Password	string	The new password for the account. Password strength is tested through heuristic algorithms. For more information, see the zxcvbn GitHub.
PhoneNumber	string	The new landline phone number of the account owner.
State	string	The new state of the account owner.
VatNumber	string	The new value added tax (VAT) number for the account.
ZipCode	string	The new ZIP code of the city.

Schema

{
  "City": "string",
  "CompanyName": "string",
  "Country": "string",
  "Email": "string",
  "FirstName": "string",
  "JobTitle": "string",
  "LastName": "string",
  "MobileNumber": "string",
  "Password": "string",
  "PhoneNumber": "string",
  "State": "string",
  "VatNumber": "string",
  "ZipCode": "string"
}

UpdateAccountResponse

Property	Type	Description
ResponseMetadata	ResponseMetadata	Information about the response.
Return	boolean	Always true when the request succeeds.

Schema

{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "Return": true
}

UpdateListenerRuleRequest

Property	Type	Description
Attribute	string	The attribute of rule that needs to be modified (HostPattern | PathPattern).
RuleName	string	The name of the listener rule.
Value	string	The new value for the attribute.

Schema

{
  "Attribute": "string",
  "RuleName": "string",
  "Value": "string"
}

UpdateListenerRuleResponse

Property	Type	Description
ResponseMetadata	ResponseMetadata	Information about the response.
Return	boolean	Always true when the request succeeds.

Schema

{
  "ResponseMetadata": {
    "RequestId": "string"
  },
  "Return": true
}