Skip to content

create_centralization_rule_for_organization async 

create_centralization_rule_for_organization(
    rule_name: RuleName,
    rule: CentralizationRule,
    *,
    config_overrides: Optional[AsyncObservabilityAdminClientConfig] = None,
    tags: Optional[TagMapInput] = None,
) -> CreateCentralizationRuleForOrganizationOutput

Creates a centralization rule that applies across an Amazon Web Services Organization. This operation can only be called by the organization's management account or a delegated administrator account.

Parameters:

  • rule_name (RuleName) –

    A unique name for the organization-wide centralization rule being created.

  • rule (CentralizationRule) –

    The configuration details for the organization-wide centralization rule, including the source configuration and the destination configuration to centralize telemetry data across the organization.

  • tags (Optional[TagMapInput], default: None ) –

    The key-value pairs to associate with the organization telemetry rule resource for categorization and management purposes.

Raises:

Source code in docs_src/capo_observabilityadmin/_services/async_observability_admin.py 
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
async def create_centralization_rule_for_organization(
    self,
    rule_name: "capo_observabilityadmin.types.rule_name.RuleName",
    rule: "capo_observabilityadmin.types.centralization_rule.CentralizationRule",
    *,
    config_overrides: Optional[AsyncObservabilityAdminClientConfig] = None,
    tags: Optional[
        "capo_observabilityadmin.types.tag_map_input.TagMapInput"
    ] = None,
) -> "capo_observabilityadmin.types.create_centralization_rule_for_organization_output.CreateCentralizationRuleForOrganizationOutput":
    """<p>Creates a centralization rule that applies across an Amazon Web Services Organization. This operation can only be called by the organization's management account or a delegated administrator account.</p>

    Args:
        rule_name: <p>A unique name for the organization-wide centralization rule being created.</p>
        rule: <p>The configuration details for the organization-wide centralization rule, including the source configuration and the destination configuration to centralize telemetry data across the organization.</p>
        tags: <p>The key-value pairs to associate with the organization telemetry rule resource for categorization and management purposes.</p>

    Raises:
        capo_observabilityadmin.errors.access_denied_exception.AccessDeniedException: <p> Indicates you don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html">Access management for Amazon Web Services resources</a> in the IAM user guide. </p>
        capo_observabilityadmin.errors.conflict_exception.ConflictException: <p> The requested operation conflicts with the current state of the specified resource or with another request. </p>
        capo_observabilityadmin.errors.internal_server_exception.InternalServerException: <p> Indicates the request has failed to process because of an unknown server error, exception, or failure. </p>
        capo_observabilityadmin.errors.service_quota_exceeded_exception.ServiceQuotaExceededException: <p> The requested operation would exceed the allowed quota for the specified resource type. </p>
        capo_observabilityadmin.errors.too_many_requests_exception.TooManyRequestsException: <p> The request throughput limit was exceeded. </p>
        capo_observabilityadmin.errors.validation_exception.ValidationException: <p> Indicates input validation failed. Check your request parameters and retry the request. </p>
        capo_observabilityadmin.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_observabilityadmin.types.create_centralization_rule_for_organization_input.CreateCentralizationRuleForOrganizationInput]",
    ) -> AsyncOperationResponse[
        "capo_observabilityadmin.types.create_centralization_rule_for_organization_output.CreateCentralizationRuleForOrganizationOutput"
    ]:
        import capo_observabilityadmin._operations.observability_admin.create_centralization_rule_for_organization

        (
            output,
            http_response,
        ) = await capo_observabilityadmin._operations.observability_admin.create_centralization_rule_for_organization.async_create_centralization_rule_for_organization(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides,
        OperationLogging("CreateCentralizationRuleForOrganization"),
    )
    input_: capo_observabilityadmin.types.create_centralization_rule_for_organization_input.CreateCentralizationRuleForOrganizationInput = {
        "rule_name": rule_name,
        "rule": rule,
    }
    if tags is not None:
        input_["tags"] = tags

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output