This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

CLIs

1: Check Queue Name Duplication

1.1: 1.0

2: Create Queue

2.1: 1.0

3: Delete Acl

3.1: 1.0

4: Delete Queue

4.1: 1.0

5: List Queue

5.1: 1.0

6: Set Acl

6.1: 1.0

7: Show Queue

7.1: 1.0

8: Update Queue Config

8.1: 1.0

9: Update Queue Description

9.1: 1.0

1 - Check Queue Name Duplication

1.1 - 1.0

scpcli queueservice check queue name duplication
--name <value>

Description

check queue name duplication

State ACTIVE (CURRENT)

Version	Supported Until
1.0	-

Parameters

Name	Type	Description	Example
name required	string	Queue name	`test-queue.fifo`

Responses

Name	Description	Example
result	Result	True

2 - Create Queue

2.1 - 1.0

scpcli queueservice queue create
--id <value>
--name <value>
--message_size <value>
--message_retention_period_unit <value>
--message_retention_period <value>
[--data_key_reuse_period <value>]
[--data_key_reuse_period_unit <value>]
[--description <value>]
[--tags <value>]

Description

create a queue

State ACTIVE (CURRENT)

Version	Supported Until
1.0	-

Parameters

Name	Type	Description	Example
id required	string	KMS ID	`8c9f6c1c928a45b4bbd1e4da5531d656`
name required	string	KMS name	`test-kms`
message_size required	integer	Message size	`256`
message_retention_period_unit required	string	Period unit	`minute`
message_retention_period required	integer	Message retention period	`40`
data_key_reuse_period optional	integer	Data key reuse period	`40`
data_key_reuse_period_unit optional	****	Period unit	`minute`
description optional	string	Description	`Queue description`
tags optional	array	Tag List	`'{"key": "key1", "value": "value1"}'`

Responses

Name	Description	Example
id	Queue ID	8c9f6c1c928a45b4bbd1e4da5531d656
messages	Description	Create Queue
state	Queue state	ACTIVE

3 - Delete Acl

3.1 - 1.0

scpcli queueservice queue delete acl
--queue_id <value>
--ip_address <value>

Description

delete an acl policy

State ACTIVE (CURRENT)

Version	Supported Until
1.0	-

Parameters

Name	Type	Description	Example
queue_id required	string	Queue ID	`8c9f6c1c928a45b4bbd1e4da5531d656`
ip_address required	array	Access Allowed IP List	`0.0.0.0`

4 - Delete Queue

4.1 - 1.0

scpcli queueservice queue delete
--queue_id <value>

Description

delete a specific queue

State ACTIVE (CURRENT)

Version	Supported Until
1.0	-

Parameters

Name	Type	Description	Example
queue_id required	string	Queue ID	`8c9f6c1c928a45b4bbd1e4da5531d656`

5 - List Queue

5.1 - 1.0

scpcli queueservice queue list
[--size <value>]
[--page <value>]
[--sort <value>]
[--name <value>]

Description

list queue

State ACTIVE (CURRENT)

Version	Supported Until
1.0	-

Parameters

Name	Type	Description	Example
size optional	integer	size	`20`
page optional	integer	page	`0`
sort optional	string	sort	`created_at:desc`
name optional	string	Queue name	`test-queue.fifo`

Responses

Name	Description	Example
id	Queue ID	8c9f6c1c928a45b4bbd1e4da5531d656
account_id	Account ID	8c9f6c1c928a45b4bbd1e4da5531d656
created_at	Created At	2024-05-17T00:23:17Z
created_by	Created By	90dddfc2b1e04edba54ba2b41539a9ac
encryption	Encryption
modified_at	Modified At	2024-05-17T00:23:17Z
modified_by	Modified By	90dddfc2b1e04edba54ba2b41539a9ac
name	Queue name	test-queue.fifo
number_wait_messages	Number of waiting messages	10
state	Queue state	ACTIVE
type	Queue Type	FIFO

6 - Set Acl

6.1 - 1.0

scpcli queueservice queue set acl
--queue_id <value>
--ip_address <value>

Description

update an acl policy

State ACTIVE (CURRENT)

Version	Supported Until
1.0	-

Parameters

Name	Type	Description	Example
queue_id required	string	Queue ID	`8c9f6c1c928a45b4bbd1e4da5531d656`
ip_address required	array	Access Allowed IP List	`0.0.0.0`

Responses

Name	Description	Example
id	Queue ID	8c9f6c1c928a45b4bbd1e4da5531d656

7 - Show Queue

7.1 - 1.0

scpcli queueservice queue show
--queue_id <value>

Description

show a specific queue

State ACTIVE (CURRENT)

Version	Supported Until
1.0	-

Parameters

Name	Type	Description	Example
queue_id required	string	Queue ID	`8c9f6c1c928a45b4bbd1e4da5531d656`

Responses

Name	Description	Example
ip_address	IP address	192.168.0.0

8 - Update Queue Config

8.1 - 1.0

scpcli queueservice queue set config
--queue_id <value>
--name <value>
--id <value>
--message_size <value>
--message_retention_period_unit <value>
--message_retention_period <value>
[--data_key_reuse_period <value>]
[--data_key_reuse_period_unit <value>]

Description

update queue config

State ACTIVE (CURRENT)

Version	Supported Until
1.0	-

Parameters

Name	Type	Description	Example
queue_id required	string	Queue ID	`8c9f6c1c928a45b4bbd1e4da5531d656`
name required	string	KMS name	`test-kms`
id required	string	KMS ID	`8c9f6c1c928a45b4bbd1e4da5531d656`
message_size required	integer	Message size	`256`
message_retention_period_unit required	string	Period unit	`minute`
message_retention_period required	integer	Message retention period	`40`
data_key_reuse_period optional	integer	Data key reuse period	`40`
data_key_reuse_period_unit optional	****	Period unit	`minute`

9 - Update Queue Description

9.1 - 1.0

scpcli queueservice queue set description
--queue_id <value>
--description <value>

Description

update queue description

State ACTIVE (CURRENT)

Version	Supported Until
1.0	-

Parameters

Name	Type	Description	Example
queue_id required	string	Queue ID	`8c9f6c1c928a45b4bbd1e4da5531d656`
description required	string	Description	`Queue description`