Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

ListRuleGroupsNamespaces

Returns a list of rule groups namespaces in a workspace.

Request Syntax


GET /workspaces/workspaceId/rulegroupsnamespaces?maxResults=maxResults&name=name&nextToken=nextToken HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

maxResults

The maximum number of results to return. The default is 100.

Valid Range: Minimum value of 1. Maximum value of 1000.

name

Use this parameter to filter the rule groups namespaces that are returned. Only the namespaces with names that begin with the value that you specify are returned.

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [0-9A-Za-z][-.0-9A-Z_a-z]*

nextToken

The token for the next set of items to return. You receive this token from a previous call, and use it to get the next page of results. The other parameters must be the same as the initial call.

For example, if your initial request has maxResults of 10, and there are 12 rule groups namespaces to return, then your initial request will return 10 and a nextToken. Using the next token in a subsequent call will return the remaining 2 namespaces.

Length Constraints: Minimum length of 0. Maximum length of 1000.

workspaceId

The ID of the workspace containing the rule groups namespaces.

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [0-9A-Za-z][-.0-9A-Z_a-z]*

Required: Yes

Request Body

The request does not have a request body.

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "ruleGroupsNamespaces": [ 
      { 
         "arn": "string",
         "createdAt": number,
         "modifiedAt": number,
         "name": "string",
         "status": { 
            "statusCode": "string",
            "statusReason": "string"
         },
         "tags": { 
            "string" : "string" 
         }
      }
   ]
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

nextToken

A token indicating that there are more results to retrieve. You can use this token as part of your next ListRuleGroupsNamespaces request to retrieve those results.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 1000.

ruleGroupsNamespaces

The returned list of rule groups namespaces.

Type: Array of RuleGroupsNamespaceSummary objects

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 403

InternalServerException

An unexpected error occurred during the processing of the request.

HTTP Status Code: 500

ResourceNotFoundException

The request references a resources that doesn't exist.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

ValidationException

The input fails to satisfy the constraints specified by an AWS service.

HTTP Status Code: 400