modify_ipam_resource_discovery ¶

def modify_ipam_resource_discovery(
    self,
    *,
    config_overrides: Optional[EC2ClientConfig] = None,
    dry_run: Optional["capo_ec2.types.boolean.Boolean"] = None,
    ipam_resource_discovery_id: Optional[
        "capo_ec2.types.ipam_resource_discovery_id.IpamResourceDiscoveryId"
    ] = None,
    description: Optional["capo_ec2.types.string.String"] = None,
    add_operating_regions: Optional[
        "capo_ec2.types.add_ipam_operating_region_set.AddIpamOperatingRegionSet"
    ] = None,
    remove_operating_regions: Optional[
        "capo_ec2.types.remove_ipam_operating_region_set.RemoveIpamOperatingRegionSet"
    ] = None,
    add_organizational_unit_exclusions: Optional[
        "capo_ec2.types.add_ipam_organizational_unit_exclusion_set.AddIpamOrganizationalUnitExclusionSet"
    ] = None,
    remove_organizational_unit_exclusions: Optional[
        "capo_ec2.types.remove_ipam_organizational_unit_exclusion_set.RemoveIpamOrganizationalUnitExclusionSet"
    ] = None,
) -> "capo_ec2.types.modify_ipam_resource_discovery_result.ModifyIpamResourceDiscoveryResult":
    """<p>Modifies a resource discovery. A resource discovery is an IPAM component that enables IPAM to manage and monitor resources that belong to the owning account.</p>

    Args:
        dry_run: <p>A check for whether you have the required permissions for the action without actually making the request and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
        ipam_resource_discovery_id: <p>A resource discovery ID.</p>
        description: <p>A resource discovery description.</p>
        add_operating_regions: <p>Add operating Regions to the resource discovery. Operating Regions are Amazon Web Services Regions where the IPAM is allowed to manage IP address CIDRs. IPAM only discovers and monitors resources in the Amazon Web Services Regions you select as operating Regions.</p>
        remove_operating_regions: <p>Remove operating Regions.</p>
        add_organizational_unit_exclusions: <p>Add an Organizational Unit (OU) exclusion to your IPAM. If your IPAM is integrated with Amazon Web Services Organizations and you add an organizational unit (OU) exclusion, IPAM will not manage the IP addresses in accounts in that OU exclusion. There is a limit on the number of exclusions you can create. For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/ipam/quotas-ipam.html">Quotas for your IPAM</a> in the <i>Amazon VPC IPAM User Guide</i>.</p> <note> <p>The resulting set of exclusions must not result in "overlap", meaning two or more OU exclusions must not exclude the same OU. For more information and examples, see the Amazon Web Services CLI request process in <a href="https://docs.aws.amazon.com/vpc/latest/ipam/exclude-ous.html#exclude-ous-create-delete">Add or remove OU exclusions </a> in the <i>Amazon VPC User Guide</i>.</p> </note>
        remove_organizational_unit_exclusions: <p>Remove an Organizational Unit (OU) exclusion to your IPAM. If your IPAM is integrated with Amazon Web Services Organizations and you add an organizational unit (OU) exclusion, IPAM will not manage the IP addresses in accounts in that OU exclusion. There is a limit on the number of exclusions you can create. For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/ipam/quotas-ipam.html">Quotas for your IPAM</a> in the <i>Amazon VPC IPAM User Guide</i>.</p> <note> <p>The resulting set of exclusions must not result in "overlap", meaning two or more OU exclusions must not exclude the same OU. For more information and examples, see the Amazon Web Services CLI request process in <a href="https://docs.aws.amazon.com/vpc/latest/ipam/exclude-ous.html#exclude-ous-create-delete">Add or remove OU exclusions </a> in the <i>Amazon VPC User Guide</i>.</p> </note>

    Raises:
        capo_ec2.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_ec2.types.modify_ipam_resource_discovery_request.ModifyIpamResourceDiscoveryRequest]",
    ) -> OperationResponse[
        "capo_ec2.types.modify_ipam_resource_discovery_result.ModifyIpamResourceDiscoveryResult"
    ]:
        import capo_ec2._operations.amazon_ec2.modify_ipam_resource_discovery

        output, http_response = (
            capo_ec2._operations.amazon_ec2.modify_ipam_resource_discovery.modify_ipam_resource_discovery(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ModifyIpamResourceDiscovery")
    )
    input_: capo_ec2.types.modify_ipam_resource_discovery_request.ModifyIpamResourceDiscoveryRequest = {}
    if dry_run is not None:
        input_["dry_run"] = dry_run
    if ipam_resource_discovery_id is not None:
        input_["ipam_resource_discovery_id"] = ipam_resource_discovery_id
    if description is not None:
        input_["description"] = description
    if add_operating_regions is not None:
        input_["add_operating_regions"] = add_operating_regions
    if remove_operating_regions is not None:
        input_["remove_operating_regions"] = remove_operating_regions
    if add_organizational_unit_exclusions is not None:
        input_["add_organizational_unit_exclusions"] = (
            add_organizational_unit_exclusions
        )
    if remove_organizational_unit_exclusions is not None:
        input_["remove_organizational_unit_exclusions"] = (
            remove_organizational_unit_exclusions
        )

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output