Oracle GoldenGate Microservices Architecture REST API

Patch Authorization Profile

patch

/services/{version}/deployments/{deployment}/authorization/profiles/{profile}

Patch the content of a given profile

Request

Supported Media Types

application/json

Path Parameters

deployment: string

Minimum Length: 1

Maximum Length: 32

Pattern: ^[A-Za-z][A-Za-z0-9-_.]*$

Name for the Oracle GoldenGate deployment.
profile: string

Minimum Length: 1

Maximum Length: 32

Pattern: ^[A-Za-z][A-Za-z0-9-_.]*$

Name of Authorization profile.
version: string

Oracle GoldenGate Service API version.

Allowed Values: [ "v2" ]

Root Schema : Oracle GoldenGate Authorization Profile definition

Type: object

Title: Oracle GoldenGate Authorization Profile definition

Describes the which type of authorization OGG should use.

Match One

Show Source

object Oracle GoldenGate Authorization Profile definition-x-oneOf[0]

Profile for using the deployment's credential store
object Oracle GoldenGate Authorization Profile definition-x-oneOf[1]

Profile for using an IDCS as an Identity Provider

{
    "x-oneOf":[
        {
            "description":"Profile for using the deployment's credential store",
            "type":"object",
            "properties":{
                "$schema":{
                    "enum":[
                        "ogg:authorizationProfile"
                    ]
                },
                "type":{
                    "description":"OGG local credential store",
                    "enum":[
                        "localCredentialStore"
                    ]
                },
                "description":{
                    "description":"Description of the local credential store",
                    "type":"string",
                    "minLength":1,
                    "maxLength":4096
                },
                "enabled":{
                    "description":"Flag to show whether the profile is enabled for the deployment or not",
                    "type":"boolean",
                    "default":false
                }
            },
            "required":[
                "type"
            ],
            "additionalProperties":false
        },
        {
            "description":"Profile for using an IDCS as an Identity Provider",
            "properties":{
                "clientID":{
                    "description":"ClientID for IDCS app",
                    "type":"string",
                    "minLength":1,
                    "maxLength":256
                },
                "groupToRoles":{
                    "description":"User mapping for IDCS groups to OGG roles",
                    "type":"object",
                    "properties":{
                        "securityGroup":{
                            "description":"Name of a group in IDCS",
                            "type":"string",
                            "minLength":0,
                            "maxLength":4095
                        },
                        "administratorGroup":{
                            "description":"Name of a group in IDCS",
                            "type":"string",
                            "minLength":0,
                            "maxLength":4095
                        },
                        "operatorGroup":{
                            "description":"Name of a group in IDCS",
                            "type":"string",
                            "minLength":0,
                            "maxLength":4095
                        },
                        "userGroup":{
                            "description":"Name of a group in IDCS",
                            "type":"string",
                            "minLength":0,
                            "maxLength":4095
                        }
                    },
                    "additionalProperties":false
                },
                "tenantDiscoveryURI":{
                    "description":"IDCS server well-known discovery endpoint URI",
                    "type":"string",
                    "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
                    "minLength":2,
                    "maxLength":4095
                },
                "enabled":{
                    "description":"Flag to show whether the profile is enabled for the deployment or not",
                    "type":"boolean",
                    "default":false
                },
                "$schema":{
                    "enum":[
                        "ogg:authorizationProfile"
                    ]
                },
                "type":{
                    "description":"OpenID enabled IDCS server",
                    "enum":[
                        "idcs",
                        "iam"
                    ]
                },
                "signingCertificateTTL":{
                    "description":"Signing certificate Time-To-Live (seconds), 0 means check on every request",
                    "type":"integer",
                    "minimum":0,
                    "maximum":4.294967295E9,
                    "default":3600
                },
                "clientSecret":{
                    "description":"Client secret for IDCS app",
                    "type":"string",
                    "minLength":1,
                    "maxLength":256
                },
                "description":{
                    "description":"Profile description",
                    "type":"string",
                    "minLength":1,
                    "maxLength":1024
                }
            },
            "additionalProperties":false
        }
    ],
    "title":"Oracle GoldenGate Authorization Profile definition",
    "description":"Describes the which type of authorization OGG should use.",
    "type":"object"
}

Nested Schema : Oracle GoldenGate Authorization Profile definition-x-oneOf[0]

Type: object

Profile for using the deployment's credential store

Show Source

$schema(optional):

Allowed Values: [ "ogg:authorizationProfile" ]
description(optional): string

Minimum Length: 1

Maximum Length: 4096

Description of the local credential store
enabled(optional): boolean

Default Value: false

Flag to show whether the profile is enabled for the deployment or not
type:

Allowed Values: [ "localCredentialStore" ]

OGG local credential store

{
    "description":"Profile for using the deployment's credential store",
    "type":"object",
    "properties":{
        "$schema":{
            "enum":[
                "ogg:authorizationProfile"
            ]
        },
        "type":{
            "description":"OGG local credential store",
            "enum":[
                "localCredentialStore"
            ]
        },
        "description":{
            "description":"Description of the local credential store",
            "type":"string",
            "minLength":1,
            "maxLength":4096
        },
        "enabled":{
            "description":"Flag to show whether the profile is enabled for the deployment or not",
            "type":"boolean",
            "default":false
        }
    },
    "required":[
        "type"
    ],
    "additionalProperties":false
}

Nested Schema : Oracle GoldenGate Authorization Profile definition-x-oneOf[1]

Type: object

Profile for using an IDCS as an Identity Provider

Show Source

$schema(optional):

Allowed Values: [ "ogg:authorizationProfile" ]
clientID(optional): string

Minimum Length: 1

Maximum Length: 256

ClientID for IDCS app
clientSecret(optional): string

Minimum Length: 1

Maximum Length: 256

Client secret for IDCS app
description(optional): string

Minimum Length: 1

Maximum Length: 1024

Profile description
enabled(optional): boolean

Default Value: false

Flag to show whether the profile is enabled for the deployment or not
groupToRoles(optional): object groupToRoles

User mapping for IDCS groups to OGG roles
signingCertificateTTL(optional): integer

Minimum Value: 0

Maximum Value: 4.294967295E9

Default Value: 3600

Signing certificate Time-To-Live (seconds), 0 means check on every request
tenantDiscoveryURI(optional): string

Minimum Length: 2

Maximum Length: 4095

Pattern: ^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \t]*$

IDCS server well-known discovery endpoint URI
type(optional):

Allowed Values: [ "idcs", "iam" ]

OpenID enabled IDCS server

{
    "description":"Profile for using an IDCS as an Identity Provider",
    "properties":{
        "clientID":{
            "description":"ClientID for IDCS app",
            "type":"string",
            "minLength":1,
            "maxLength":256
        },
        "groupToRoles":{
            "description":"User mapping for IDCS groups to OGG roles",
            "type":"object",
            "properties":{
                "securityGroup":{
                    "description":"Name of a group in IDCS",
                    "type":"string",
                    "minLength":0,
                    "maxLength":4095
                },
                "administratorGroup":{
                    "description":"Name of a group in IDCS",
                    "type":"string",
                    "minLength":0,
                    "maxLength":4095
                },
                "operatorGroup":{
                    "description":"Name of a group in IDCS",
                    "type":"string",
                    "minLength":0,
                    "maxLength":4095
                },
                "userGroup":{
                    "description":"Name of a group in IDCS",
                    "type":"string",
                    "minLength":0,
                    "maxLength":4095
                }
            },
            "additionalProperties":false
        },
        "tenantDiscoveryURI":{
            "description":"IDCS server well-known discovery endpoint URI",
            "type":"string",
            "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
            "minLength":2,
            "maxLength":4095
        },
        "enabled":{
            "description":"Flag to show whether the profile is enabled for the deployment or not",
            "type":"boolean",
            "default":false
        },
        "$schema":{
            "enum":[
                "ogg:authorizationProfile"
            ]
        },
        "type":{
            "description":"OpenID enabled IDCS server",
            "enum":[
                "idcs",
                "iam"
            ]
        },
        "signingCertificateTTL":{
            "description":"Signing certificate Time-To-Live (seconds), 0 means check on every request",
            "type":"integer",
            "minimum":0,
            "maximum":4.294967295E9,
            "default":3600
        },
        "clientSecret":{
            "description":"Client secret for IDCS app",
            "type":"string",
            "minLength":1,
            "maxLength":256
        },
        "description":{
            "description":"Profile description",
            "type":"string",
            "minLength":1,
            "maxLength":1024
        }
    },
    "additionalProperties":false
}

Nested Schema : groupToRoles

Type: object

User mapping for IDCS groups to OGG roles

Show Source

administratorGroup(optional): string

Minimum Length: 0

Maximum Length: 4095

Name of a group in IDCS
operatorGroup(optional): string

Minimum Length: 0

Maximum Length: 4095

Name of a group in IDCS
securityGroup(optional): string

Minimum Length: 0

Maximum Length: 4095

Name of a group in IDCS
userGroup(optional): string

Minimum Length: 0

Maximum Length: 4095

Name of a group in IDCS

{
    "description":"User mapping for IDCS groups to OGG roles",
    "type":"object",
    "properties":{
        "securityGroup":{
            "description":"Name of a group in IDCS",
            "type":"string",
            "minLength":0,
            "maxLength":4095
        },
        "administratorGroup":{
            "description":"Name of a group in IDCS",
            "type":"string",
            "minLength":0,
            "maxLength":4095
        },
        "operatorGroup":{
            "description":"Name of a group in IDCS",
            "type":"string",
            "minLength":0,
            "maxLength":4095
        },
        "userGroup":{
            "description":"Name of a group in IDCS",
            "type":"string",
            "minLength":0,
            "maxLength":4095
        }
    },
    "additionalProperties":false
}

Example Request (application/json)

{
    "clientID":"4a33ef81bf1642689ac83742a27b8a94",
    "clientSecret":"166155e9-884d-4eb3-9733-21f98f0698bc",
    "tenantDiscoveryURI":"https://idcs-17eca02d31a645e78710ad52ac01dd40.identity.c9dev2.oc9qadev.com/.well-known/openid-configuration",
    "groupToRoles":{
        "securityGroup":"Demo-source-security",
        "administratorGroup":"Demo-source-admin"
    },
    "enabled":true
}

Response

Supported Media Types

application/json

200 Response

The Authorization Profile was successfully altered

Root Schema : RESTful API Standard Response

Type: object

Title: RESTful API Standard Response

Standard Response for all Oracle GoldenGate RESTful API calls

Show Source

$schema(optional):

Allowed Values: [ "api:standardResponse" ]
links: array links

Minimum Number of Items: 0

Maximum Number of Items: 16

Oracle GoldenGate links for the request
messages: array messages

Minimum Number of Items: 0

Maximum Number of Items: 65535

Oracle GoldenGate messages issued during the request
response(optional): object response

Oracle GoldenGate document from the request

{
    "title":"RESTful API Standard Response",
    "description":"Standard Response for all Oracle GoldenGate RESTful API calls",
    "required":[
        "messages",
        "links"
    ],
    "type":"object",
    "properties":{
        "$schema":{
            "enum":[
                "api:standardResponse"
            ]
        },
        "response":{
            "description":"Oracle GoldenGate document from the request",
            "type":"object"
        },
        "messages":{
            "description":"Oracle GoldenGate messages issued during the request",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "$schema":{
                        "enum":[
                            "ogg:message"
                        ]
                    },
                    "type":{
                        "description":"An absolute URI [RFC3986] to a page that describes the info, warning or error type.",
                        "type":"string",
                        "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
                        "minLength":2,
                        "maxLength":4095
                    },
                    "title":{
                        "description":"A human-readable description that provides information and detail specific to this occurence of the information, warning or error.",
                        "type":"string",
                        "minLength":1,
                        "maxLength":4095
                    },
                    "code":{
                        "description":"The Oracle GoldenGate message code",
                        "type":"string",
                        "pattern":"^OGG[-][0-9]{5}$",
                        "minLength":9,
                        "maxLength":9
                    },
                    "severity":{
                        "description":"The severity of the message",
                        "enum":[
                            "INFO",
                            "WARNING",
                            "ERROR"
                        ]
                    },
                    "issued":{
                        "description":"The date and time that the message was issued",
                        "type":"string",
                        "pattern":"^[0-9]{4}[-](0[1-9]|1[0-2])[-](0[1-9]|[12][0-9]|3[01])[tT ]([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]{1,6})?([zZ]|[+-][0-9][0-9]:[0-5][0-9])$",
                        "minLength":20,
                        "maxLength":32
                    }
                },
                "required":[
                    "type",
                    "title",
                    "code",
                    "severity",
                    "issued"
                ],
                "additionalProperties":false
            },
            "minItems":0,
            "maxItems":65535
        },
        "links":{
            "description":"Oracle GoldenGate links for the request",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "$schema":{
                        "enum":[
                            "ogg:link"
                        ]
                    },
                    "rel":{
                        "description":"Relationship of href to the requested link",
                        "enum":[
                            "alternate",
                            "canonical",
                            "current",
                            "describedby",
                            "describes",
                            "enclosure",
                            "parent",
                            "related",
                            "self",
                            "first",
                            "last",
                            "next",
                            "previous"
                        ]
                    },
                    "href":{
                        "description":"An absolute URI for the link",
                        "type":"string",
                        "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
                        "minLength":2,
                        "maxLength":4095
                    },
                    "mediaType":{
                        "description":"Media type - see RFC 4288 (https://tools.ietf.org/html/rfc4288)",
                        "type":"string",
                        "pattern":"^(text|application)/[a-zA-Z0-9!#$&.+-^_]+$",
                        "minLength":6,
                        "maxLength":255
                    },
                    "description":{
                        "description":"A human-readable description that provides information and detail specific to this link.",
                        "type":"string",
                        "minLength":1,
                        "maxLength":4095
                    }
                },
                "required":[
                    "rel",
                    "href"
                ],
                "additionalProperties":false
            },
            "minItems":0,
            "maxItems":16
        }
    },
    "additionalProperties":false
}

Nested Schema : links

Type: array

Minimum Number of Items: 0

Maximum Number of Items: 16

Oracle GoldenGate links for the request

Show Source

Array of: object items

{
    "description":"Oracle GoldenGate links for the request",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "$schema":{
                "enum":[
                    "ogg:link"
                ]
            },
            "rel":{
                "description":"Relationship of href to the requested link",
                "enum":[
                    "alternate",
                    "canonical",
                    "current",
                    "describedby",
                    "describes",
                    "enclosure",
                    "parent",
                    "related",
                    "self",
                    "first",
                    "last",
                    "next",
                    "previous"
                ]
            },
            "href":{
                "description":"An absolute URI for the link",
                "type":"string",
                "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
                "minLength":2,
                "maxLength":4095
            },
            "mediaType":{
                "description":"Media type - see RFC 4288 (https://tools.ietf.org/html/rfc4288)",
                "type":"string",
                "pattern":"^(text|application)/[a-zA-Z0-9!#$&.+-^_]+$",
                "minLength":6,
                "maxLength":255
            },
            "description":{
                "description":"A human-readable description that provides information and detail specific to this link.",
                "type":"string",
                "minLength":1,
                "maxLength":4095
            }
        },
        "required":[
            "rel",
            "href"
        ],
        "additionalProperties":false
    },
    "minItems":0,
    "maxItems":16
}

Nested Schema : messages

Type: array

Minimum Number of Items: 0

Maximum Number of Items: 65535

Oracle GoldenGate messages issued during the request

Show Source

Array of: object items

{
    "description":"Oracle GoldenGate messages issued during the request",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "$schema":{
                "enum":[
                    "ogg:message"
                ]
            },
            "type":{
                "description":"An absolute URI [RFC3986] to a page that describes the info, warning or error type.",
                "type":"string",
                "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
                "minLength":2,
                "maxLength":4095
            },
            "title":{
                "description":"A human-readable description that provides information and detail specific to this occurence of the information, warning or error.",
                "type":"string",
                "minLength":1,
                "maxLength":4095
            },
            "code":{
                "description":"The Oracle GoldenGate message code",
                "type":"string",
                "pattern":"^OGG[-][0-9]{5}$",
                "minLength":9,
                "maxLength":9
            },
            "severity":{
                "description":"The severity of the message",
                "enum":[
                    "INFO",
                    "WARNING",
                    "ERROR"
                ]
            },
            "issued":{
                "description":"The date and time that the message was issued",
                "type":"string",
                "pattern":"^[0-9]{4}[-](0[1-9]|1[0-2])[-](0[1-9]|[12][0-9]|3[01])[tT ]([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]{1,6})?([zZ]|[+-][0-9][0-9]:[0-5][0-9])$",
                "minLength":20,
                "maxLength":32
            }
        },
        "required":[
            "type",
            "title",
            "code",
            "severity",
            "issued"
        ],
        "additionalProperties":false
    },
    "minItems":0,
    "maxItems":65535
}

Nested Schema : response

Type: object

Oracle GoldenGate document from the request

Nested Schema : items

Type: object

Show Source

$schema(optional):

Allowed Values: [ "ogg:link" ]
description(optional): string

Minimum Length: 1

Maximum Length: 4095

A human-readable description that provides information and detail specific to this link.
href: string

Minimum Length: 2

Maximum Length: 4095

Pattern: ^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \t]*$

An absolute URI for the link
mediaType(optional): string

Minimum Length: 6

Maximum Length: 255

Pattern: ^(text|application)/[a-zA-Z0-9!#$&.+-^_]+$

Media type - see RFC 4288 (https://tools.ietf.org/html/rfc4288)
rel:

Allowed Values: [ "alternate", "canonical", "current", "describedby", "describes", "enclosure", "parent", "related", "self", "first", "last", "next", "previous" ]

Relationship of href to the requested link

{
    "type":"object",
    "properties":{
        "$schema":{
            "enum":[
                "ogg:link"
            ]
        },
        "rel":{
            "description":"Relationship of href to the requested link",
            "enum":[
                "alternate",
                "canonical",
                "current",
                "describedby",
                "describes",
                "enclosure",
                "parent",
                "related",
                "self",
                "first",
                "last",
                "next",
                "previous"
            ]
        },
        "href":{
            "description":"An absolute URI for the link",
            "type":"string",
            "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
            "minLength":2,
            "maxLength":4095
        },
        "mediaType":{
            "description":"Media type - see RFC 4288 (https://tools.ietf.org/html/rfc4288)",
            "type":"string",
            "pattern":"^(text|application)/[a-zA-Z0-9!#$&.+-^_]+$",
            "minLength":6,
            "maxLength":255
        },
        "description":{
            "description":"A human-readable description that provides information and detail specific to this link.",
            "type":"string",
            "minLength":1,
            "maxLength":4095
        }
    },
    "required":[
        "rel",
        "href"
    ],
    "additionalProperties":false
}

Nested Schema : items

Type: object

Show Source

$schema(optional):

Allowed Values: [ "ogg:message" ]
code: string

Minimum Length: 9

Maximum Length: 9

Pattern: ^OGG[-][0-9]{5}$

The Oracle GoldenGate message code
issued: string

Minimum Length: 20

Maximum Length: 32

Pattern: ^[0-9]{4}[-](0[1-9]|1[0-2])[-](0[1-9]|[12][0-9]|3[01])[tT ]([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]{1,6})?([zZ]|[+-][0-9][0-9]:[0-5][0-9])$

The date and time that the message was issued
severity:

Allowed Values: [ "INFO", "WARNING", "ERROR" ]

The severity of the message
title: string

Minimum Length: 1

Maximum Length: 4095

A human-readable description that provides information and detail specific to this occurence of the information, warning or error.
type: string

Minimum Length: 2

Maximum Length: 4095

Pattern: ^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \t]*$

An absolute URI [RFC3986] to a page that describes the info, warning or error type.

{
    "type":"object",
    "properties":{
        "$schema":{
            "enum":[
                "ogg:message"
            ]
        },
        "type":{
            "description":"An absolute URI [RFC3986] to a page that describes the info, warning or error type.",
            "type":"string",
            "pattern":"^[a-zA-Z][a-zA-Z0-9+-.]*:[^ \\t]*$",
            "minLength":2,
            "maxLength":4095
        },
        "title":{
            "description":"A human-readable description that provides information and detail specific to this occurence of the information, warning or error.",
            "type":"string",
            "minLength":1,
            "maxLength":4095
        },
        "code":{
            "description":"The Oracle GoldenGate message code",
            "type":"string",
            "pattern":"^OGG[-][0-9]{5}$",
            "minLength":9,
            "maxLength":9
        },
        "severity":{
            "description":"The severity of the message",
            "enum":[
                "INFO",
                "WARNING",
                "ERROR"
            ]
        },
        "issued":{
            "description":"The date and time that the message was issued",
            "type":"string",
            "pattern":"^[0-9]{4}[-](0[1-9]|1[0-2])[-](0[1-9]|[12][0-9]|3[01])[tT ]([01][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]{1,6})?([zZ]|[+-][0-9][0-9]:[0-5][0-9])$",
            "minLength":20,
            "maxLength":32
        }
    },
    "required":[
        "type",
        "title",
        "code",
        "severity",
        "issued"
    ],
    "additionalProperties":false
}

Example Response (application/json)

{
    "$schema":"api:standardResponse",
    "links":[
        {
            "rel":"canonical",
            "href":"https://slc11xmb.us.oracle.com:9000/services/v2/deployments/sourceDeployment/authorization/profiles/sourceProfile",
            "mediaType":"application/json"
        },
        {
            "rel":"self",
            "href":"https://slc11xmb.us.oracle.com:9000/services/v2/deployments/sourceDeployment/authorization/profiles/sourceProfile",
            "mediaType":"application/json"
        }
    ],
    "messages":[
    ]
}