# Procedimientos almacenados para conceder y revocar privilegios de RDS para Db2
<a name="db2-sp-granting-revoking-privileges"></a>

Los procedimientos almacenados integrados que se describen en este tema administran usuarios, roles, grupos y autorización para bases de datos de Amazon RDS para Db2. Para ejecutar estos procedimientos, el usuario maestro debe conectarse primero a la base de datos `rdsadmin`. 

Para conocer las tareas que utilizan estos procedimientos almacenados, consulte [Concesión y revocación de privilegios](db2-granting-revoking-privileges.md) y [Configuración de la autenticación Kerberos](db2-kerberos-setting-up.md). 

Consulte los siguientes procedimientos almacenados integrados para obtener información sobre su sintaxis, parámetros, notas de uso y ejemplos.

**Topics**
+ [rdsadmin.create\$1role](#db2-sp-create-role)
+ [rdsadmin.grant\$1role](#db2-sp-grant-role)
+ [rdsadmin.revoke\$1role](#db2-sp-revoke-role)
+ [rdsadmin.drop\$1role](#db2-sp-drop-role)
+ [rdsadmin.add\$1user](#db2-sp-add-user)
+ [rdsadmin.change\$1password](#db2-sp-change-password)
+ [rdsadmin.list\$1users](#db2-sp-list-users)
+ [rdsadmin.remove\$1user](#db2-sp-remove-user)
+ [rdsadmin.add\$1groups](#db2-sp-add-groups)
+ [rdsadmin.remove\$1groups](#db2-sp-remove-groups)
+ [rdsadmin.dbadm\$1grant](#db2-sp-dbadm-grant)
+ [rdsadmin.dbadm\$1revoke](#db2-sp-dbadm-revoke)
+ [rdsadmin.set\$1sid\$1group\$1mapping](#db2-sp-set-sid-group-mapping)
+ [rdsadmin.list\$1sid\$1group\$1mapping](#db2-sp-list-sid-group-mapping)
+ [rdsadmin.remove\$1sid\$1group\$1mapping](#db2-sp-remove-sid-group-mapping)

## rdsadmin.create\$1role
<a name="db2-sp-create-role"></a>

Crea un rol.

### Sintaxis
<a name="db2-sp-create-role-syntax"></a>

```
db2 "call rdsadmin.create_role(
    'database_name',
    'role_name')"
```

### Parameters
<a name="db2-sp-create-role-parameters"></a>

Se requieren los siguientes parámetros:

*database\$1name*  
Nombre de la base de datos en la que se va a ejecutar el comando. El tipo de datos es `varchar`.

*role\$1name*  
El nombre del rol que desea crear. El tipo de datos es `varchar`.

### Notas de uso
<a name="db2-sp-create-role-usage-notes"></a>

Para obtener más información sobre cómo comprobar el estado de creación de un rol, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). 

### Ejemplos
<a name="db2-sp-create-role-examples"></a>

En el siguiente ejemplo, se crea un rol denominado `MY_ROLE` para la base de datos `DB2DB`.

```
db2 "call rdsadmin.create_role(
    'DB2DB',
    'MY_ROLE')"
```

## rdsadmin.grant\$1role
<a name="db2-sp-grant-role"></a>

Asigna un rol a un rol, usuario o grupo.

### Sintaxis
<a name="db2-sp-grant-role-syntax"></a>

```
db2 "call rdsadmin.grant_role(
    ?,
    'database_name',
    'role_name',
    'grantee',
    'admin_option')"
```

### Parameters
<a name="db2-sp-grant-role-parameters"></a>

El siguiente parámetro de salida es obligatorio: 

?  
Un marcador de parámetro que genera el identificador único de la tarea. Este parámetro solo acepta `?`.

Se requieren los siguientes parámetros de entrada:

*database\$1name*  
Nombre de la base de datos en la que se va a ejecutar el comando. El tipo de datos es `varchar`.

*role\$1name*  
El nombre del rol que desea crear. El tipo de datos es `varchar`.

*grantee*  
El rol, el usuario o el grupo que recibirá la autorización. El tipo de datos es `varchar`. Valores válidos: `ROLE`, `USER`, `GROUP`, `PUBLIC`.   
El formato debe ser un valor seguido del nombre. Separe los valores y los nombres con comas. Ejemplo: “”.: '`USER user1, user2, GROUP group1, group2`'. Reemplace los nombres con su propia información.

El siguiente parámetro de entrada es opcional:

*admin\$1option*  
Especifica si el concesionario `ROLE` tiene la autorización `DBADM` para asignar roles. El tipo de datos es `char`. El valor predeterminado es `N`.

### Notas de uso
<a name="db2-sp-grant-role-usage-notes"></a>

Para obtener más información sobre cómo comprobar el estado de asignación de un rol, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). 

### Ejemplos
<a name="db2-sp-grant-role-examples"></a>

**Ejemplo 1: asignación de un rol a un rol, usuario y grupo, y concesión de la autorización**

El siguiente ejemplo asigna un rol llamado `ROLE_TEST` para la base de datos `TESTDB` al rol llamado `role1`, al usuario llamado `user1` y al grupo llamado `group1`. `ROLE_TEST` recibe la autorización de administrador para asignar roles.

```
db2 "call rdsadmin.grant_role(
    ?,
    'TESTDB',
    'ROLE_TEST',
    'ROLE role1, USER user1, GROUP group1',
    'Y')"
```

**Ejemplo 2: asignación de un rol a `PUBLIC` y no concesión de la autorización**

En el siguiente ejemplo, se asigna un rol llamado `ROLE_TEST` para la base de datos `TESTDB` a `PUBLIC`. `ROLE_TEST` no recibe la autorización de administrador para asignar roles.

```
db2 "call rdsadmin.grant_role(
    ?,
    'TESTDB',
    'ROLE_TEST',
    'PUBLIC')"
```

## rdsadmin.revoke\$1role
<a name="db2-sp-revoke-role"></a>

Revoca un rol de un rol, usuario o grupo.

### Sintaxis
<a name="db2-sp-revoke-role-syntax"></a>

```
db2 "call rdsadmin.revoke_role(
    ?,
    'database_name',
    'role_name',
    'grantee')"
```

### Parameters
<a name="db2-sp-revoke-role-parameters"></a>

El siguiente parámetro de salida es obligatorio: 

?  
Un marcador de parámetro que genera el identificador único de la tarea. Este parámetro solo acepta ?

Se requieren los siguientes parámetros de entrada:

*database\$1name*  
Nombre de la base de datos en la que se va a ejecutar el comando. El tipo de datos es `varchar`.

*role\$1name*  
El nombre del rol que desea revocar. El tipo de datos es `varchar`.

*grantee*  
El rol, el usuario o el grupo que perderá la autorización. El tipo de datos es `varchar`. Valores válidos: `ROLE`, `USER`, `GROUP`, `PUBLIC`.   
El formato debe ser un valor seguido del nombre. Separe los valores y los nombres con comas. Ejemplo: “”.: '`USER user1, user2, GROUP group1, group2`'. Reemplace los nombres con su propia información.

### Notas de uso
<a name="db2-sp-revoke-role-usage-notes"></a>

Para obtener más información sobre cómo comprobar el estado de revocación de un rol, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). 

### Ejemplos
<a name="db2-sp-revoke-role-examples"></a>

**Ejemplo 1: revocación de un rol, usuario y grupo**

En el siguiente ejemplo, se revoca un rol llamado `ROLE_TEST` para la base de datos `TESTDB` del rol llamado `role1`, del usuario llamado `user1` y del grupo llamado `group1`.

```
db2 "call rdsadmin.revoke_role(
    ?,
    'TESTDB',
    'ROLE_TEST',
    'ROLE role1, USER user1, GROUP group1')"
```

**Ejemplo 2: revocación del rol de `PUBLIC`**

En el siguiente ejemplo, se revoca un rol llamado `ROLE_TEST` para la base de datos `TESTDB` de `PUBLIC`. 

```
db2 "call rdsadmin.revoke_role(
    ?,
    'TESTDB',
    'ROLE_TEST',
    'PUBLIC')"
```

## rdsadmin.drop\$1role
<a name="db2-sp-drop-role"></a>

Descarta un rol.

### Sintaxis
<a name="db2-sp-drop-role-syntax"></a>

```
db2 "call rdsadmin.drop_role(
    ?,
    'database_name',
    'role_name')"
```

### Parameters
<a name="db2-sp-drop-role-parameters"></a>

El siguiente parámetro de salida es obligatorio: 

?  
Un marcador de parámetro que genera el identificador único de la tarea. Este parámetro solo acepta ?

Se requieren los siguientes parámetros de entrada:

*database\$1name*  
Nombre de la base de datos en la que se va a ejecutar el comando. El tipo de datos es `varchar`.

*role\$1name*  
El nombre del rol que desea descartar. El tipo de datos es `varchar`.

### Notas de uso
<a name="db2-sp-drop-role-usage-notes"></a>

Para obtener más información sobre cómo comprobar el estado de descarte de un rol, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). 

### Ejemplos
<a name="db2-sp-drop-role-examples"></a>

En el siguiente ejemplo, se descarta un rol denominado `ROLE_TEST` para la base de datos `TESTDB`.

```
db2 "call rdsadmin.drop_role(
    ?,
    'TESTDB',
    'ROLE_TEST')"
```

## rdsadmin.add\$1user
<a name="db2-sp-add-user"></a>

Agrega un usuario a una lista de autorizaciones.

### Sintaxis
<a name="db2-sp-add-user-syntax"></a>

```
db2 "call rdsadmin.add_user(
    'username',
    'password',
    'group_name,group_name')"
```

### Parameters
<a name="db2-sp-add-user-parameters"></a>

Se requieren los siguientes parámetros:

*Nombre de usuario de*  
El nombre de usuario de un usuario. El tipo de datos es `varchar`.

*contraseña*  
La contraseña de un usuario. El tipo de datos es `varchar`.

El siguiente parámetro es opcional:

*group\$1name*  
El nombre de un grupo al que quiera agregar al usuario. El tipo de datos es `varchar`. El valor predeterminado es una cadena vacía o null. 

### Notas de uso
<a name="db2-sp-add-user-usage-notes"></a>

Puede agregar un usuario a uno o más grupos separando los nombres de los grupos con comas. 

Puede crear un grupo al crear un usuario nuevo o al [agregar un grupo a un usuario existente](db2-granting-revoking-privileges.md#add-group-to-user). No puede crear un grupo por sí mismo.

**nota**  
El número máximo de usuarios que puede agregar llamando a `rdsadmin.add_user` es de 5000.

Para obtener más información sobre cómo comprobar el estado al agregar un usuario, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). 

### Ejemplos
<a name="db2-sp-add-user-examples"></a>

En el ejemplo siguiente, se crea un usuario llamado `jorge_souza` y se asigna a los grupos denominados `sales` y `inside_sales`.

```
db2 "call rdsadmin.add_user(
    'jorge_souza',
    '*******',
    'sales,inside_sales')"
```

## rdsadmin.change\$1password
<a name="db2-sp-change-password"></a>

Cambia la contraseña de un usuario

### Sintaxis
<a name="db2-sp-change-password-syntax"></a>

```
db2 "call rdsadmin.change_password(
    'username',
    'new_password')"
```

### Parameters
<a name="db2-sp-change-password-parameters"></a>

Se requieren los siguientes parámetros:

*Nombre de usuario de*  
El nombre de usuario de un usuario. El tipo de datos es `varchar`.

*new\$1password*  
Una nueva contraseña para el usuario. El tipo de datos es `varchar`.

### Notas de uso
<a name="db2-sp-change-password-usage-notes"></a>

Para obtener información sobre cómo comprobar el estado de un cambio de contraseña, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). 

### Ejemplos
<a name="db2-sp-change-password-examples"></a>

En el siguiente ejemplo se cambia la contraseña de `jorge_souza`.

```
db2 "call rdsadmin.change_password(
    'jorge_souza',
    '*******')"
```

## rdsadmin.list\$1users
<a name="db2-sp-list-users"></a>

Muestra los usuarios de una lista de autorización. 

### Sintaxis
<a name="db2-sp-list-users-syntax"></a>

```
db2 "call rdsadmin.list_users()"
```

### Notas de uso
<a name="db2-sp-list-users-usage-notes"></a>

Para obtener más información sobre cómo comprobar el estado al mostrar los usuarios, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). 

## rdsadmin.remove\$1user
<a name="db2-sp-remove-user"></a>

Elimina el usuario de la lista de autorizaciones.

### Sintaxis
<a name="db2-sp-remove-user-syntax"></a>

```
db2 "call rdsadmin.remove_user('username')"
```

### Parameters
<a name="db2-sp-remove-user-parameters"></a>

El siguiente parámetro es obligatorio:

*Nombre de usuario de*  
El nombre de usuario de un usuario. El tipo de datos es `varchar`.

### Notas de uso
<a name="db2-sp-remove-user-usage-notes"></a>

Para obtener más información sobre cómo comprobar el estado de eliminación de un usuario, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). 

### Ejemplos
<a name="db2-sp-remove-user-examples"></a>

En el siguiente ejemplo, se impide a `jorge_souza` el acceso a las bases de datos de las instancias de bases de datos de RDS para Db2.

```
db2 "call rdsadmin.remove_user('jorge_souza')"
```

## rdsadmin.add\$1groups
<a name="db2-sp-add-groups"></a>

Agrega grupos a un usuario.

### Sintaxis
<a name="db2-sp-add-groups-syntax"></a>

```
db2 "call rdsadmin.add_groups(
    'username',
    'group_name,group_name')"
```

### Parameters
<a name="db2-sp-add-groups-parameters"></a>

Se requieren los siguientes parámetros:

*Nombre de usuario de*  
El nombre de usuario de un usuario. El tipo de datos es `varchar`.

*group\$1name*  
El nombre de un grupo al que quiera agregar al usuario. El tipo de datos es `varchar`. El valor predeterminado es una cadena vacía.

### Notas de uso
<a name="db2-sp-add-groups-usage-notes"></a>

Puede agregar uno o más grupos a un usuario separando los nombres de los grupos con comas. Para obtener más información sobre cómo comprobar el estado al agregar grupos, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). 

### Ejemplos
<a name="db2-sp-add-groups-examples"></a>

En el siguiente ejemplo, se agregan los grupos `direct_sales` y `b2b_sales` al usuario `jorge_souza`. 

```
db2 "call rdsadmin.add_groups(
    'jorge_souza',
    'direct_sales,b2b_sales')"
```

## rdsadmin.remove\$1groups
<a name="db2-sp-remove-groups"></a>

Elimina grupos de un usuario.

### Sintaxis
<a name="db2-sp-remove-groups-syntax"></a>

```
db2 "call rdsadmin.remove_groups(
    'username',
    'group_name,group_name')"
```

### Parameters
<a name="db2-sp-remove-groups-parameters"></a>

Se requieren los siguientes parámetros:

*Nombre de usuario de*  
El nombre de usuario de un usuario. El tipo de datos es `varchar`.

*group\$1name*  
El nombre de un grupo del que quiera eliminar al usuario. El tipo de datos es `varchar`.

### Notas de uso
<a name="db2-sp-remove-groups-usage-notes"></a>

Puede eliminar uno o más grupos de un usuario separando los nombres de los grupos con comas. 

Para obtener más información sobre cómo comprobar el estado de eliminación de grupos, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status). 

### Ejemplos
<a name="db2-sp-remove-groups-examples"></a>

En el ejemplo siguiente se quitan los grupos `direct_sales` y `b2b_sales` del usuario `jorge_souza`. 

```
db2 "call rdsadmin.remove_groups(
    'jorge_souza',
    'direct_sales,b2b_sales')"
```

## rdsadmin.dbadm\$1grant
<a name="db2-sp-dbadm-grant"></a>

Concede autorización `DBADM`, `ACCESSCTRL` o `DATAACCESS` a un rol, usuario o grupo.

### Sintaxis
<a name="db2-sp-dbadm-grant-syntax"></a>

```
db2 "call rdsadmin.dbadm_grant(
    ?,
    'database_name',
    'authorization',
    'grantee')"
```

### Parameters
<a name="db2-sp-dbadm-grant-parameters"></a>

El siguiente parámetro de salida es obligatorio: 

?  
Un marcador de parámetro que genera el identificador único de la tarea. Este parámetro solo acepta `?`.

Se requieren los siguientes parámetros de entrada:

*database\$1name*  
Nombre de la base de datos en la que se va a ejecutar el comando. El tipo de datos es `varchar`. 

*authorization*  
El tipo de autorización que se va a conceder. El tipo de datos es `varchar`. Valores válidos: `DBADM`, `ACCESSCTRL`, `DATAACCESS`.   
Separe los diversos tipos con comas.

*grantee*  
El rol, el usuario o el grupo que recibirá la autorización. El tipo de datos es `varchar`. Valores válidos: `ROLE`, `USER`, `GROUP`.   
El formato debe ser un valor seguido del nombre. Separe los valores y los nombres con comas. Ejemplo: “”.: '`USER user1, user2, GROUP group1, group2`'. Reemplace los nombres con su propia información.

### Notas de uso
<a name="db2-sp-dbadm-grant-usage-notes"></a>

El rol que vaya a recibir el acceso debe existir.

Para obtener más información sobre cómo comprobar el estado de concesión de acceso de administrador de base de datos, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

### Ejemplos
<a name="db2-sp-dbadm-grant-examples"></a>

**Ejemplo 1: concesión de acceso de administrador de bases de datos al rol**

El siguiente ejemplo otorga acceso de administrador de base de datos a la base de datos denominada `TESTDB` para el rol `ROLE_DBA`.

```
db2 "call rdsadmin.dbadm_grant(
    ?, 
    'TESTDB',
    'DBADM',
    'ROLE ROLE_DBA')"
```

**Ejemplo 2: concesión de acceso de administrador de bases de datos al usuario y al grupo**

El siguiente ejemplo otorga acceso de administrador de base de datos a la base de datos denominada `TESTDB` para `user1` y `group1`.

```
db2 "call rdsadmin.dbadm_grant(
    ?, 
    'TESTDB', 
    'DBADM', 
    'USER user1, GROUP group1')"
```

**Ejemplo 3: concesión de acceso de administrador de bases de datos a varios usuarios y grupos**

El siguiente ejemplo otorga acceso de administrador de base de datos a la base de datos denominada `TESTDB` para `user1`, `user2`, `group1` y `group2`.

```
db2 "call rdsadmin.dbadm_grant(
    ?, 
    'TESTDB', 
    'DBADM', 
    'USER user1, user2, GROUP group1, group2')"
```

## rdsadmin.dbadm\$1revoke
<a name="db2-sp-dbadm-revoke"></a>

Revoca la autorización `DBADM`, `ACCESSCTRL` o `DATAACCESS` de un rol, usuario o grupo.

### Sintaxis
<a name="db2-sp-dbadm-revoke-syntax"></a>

```
db2 "call rdsadmin.dbadm_revoke(
    ?,
    'database_name',
    'authorization',
    'grantee')"
```

### Parameters
<a name="db2-sp-dbadm-revoke-parameters"></a>

El siguiente parámetro de salida es obligatorio: 

?  
El identificador único de la tarea. Este parámetro solo acepta `?`.

Se requieren los siguientes parámetros de entrada:

*database\$1name*  
Nombre de la base de datos en la que se va a ejecutar el comando. El tipo de datos es `varchar`.

*authorization*  
El tipo de autorización que se va a revocar. El tipo de datos es `varchar`. Valores válidos: `DBADM`, `ACCESSCTRL`, `DATAACCESS`.   
Separe los diversos tipos con comas.

*grantee*  
El rol, el usuario o el grupo al que se va a revocar la autorización. El tipo de datos es `varchar`. Valores válidos: `ROLE`, `USER`, `GROUP`.   
El formato debe ser un valor seguido del nombre. Separe los valores y los nombres con comas. Ejemplo: “”.: '`USER user1, user2, GROUP group1, group2`'. Reemplace los nombres con su propia información.

### Notas de uso
<a name="db2-sp-dbadm-revoke-usage-notes"></a>

Para obtener más información sobre cómo comprobar el estado de revocación de acceso de administrador de base de datos, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

### Ejemplos
<a name="db2-sp-dbadm-revoke-examples"></a>

**Ejemplo 1: revocación del acceso de administrador de la base de datos de un rol**

El siguiente ejemplo revoca el acceso de administrador de base de datos a la base de datos denominada `TESTDB` para el rol `ROLE_DBA`.

```
db2 "call rdsadmin.dbadm_revoke(
    ?, 
    'TESTDB',
    'DBADM',
    'ROLE ROLE_DBA')"
```

**Ejemplo 2: revocación del acceso de administrador a la base de datos de un usuario y un grupo**

El siguiente ejemplo revoca el acceso de administrador de base de datos a la base de datos denominada `TESTDB` para `user1` y `group1`.

```
db2 "call rdsadmin.dbadm_revoke(
    ?, 
    'TESTDB', 
    'DBADM', 
    'USER user1, GROUP group1')"
```

**Ejemplo 3: revocación del acceso de administrador de la base de datos a varios usuarios y grupos**

El siguiente ejemplo revoca el acceso de administrador de base de datos a la base de datos denominada `TESTDB` para `user1`, `user2`, `group1` y `group2`.

```
db2 "call rdsadmin.dbadm_revoke(
    ?, 
    'TESTDB', 
    'DBADM', 
    'USER user1, user2, GROUP group1, group2')"
```

## rdsadmin.set\$1sid\$1group\$1mapping
<a name="db2-sp-set-sid-group-mapping"></a>

Crea una asignación entre un identificador de seguridad (SID) y el grupo de Active Directory correspondiente.

### Sintaxis
<a name="db2-sp-set-sid-group-mapping-syntax"></a>

```
db2 "call rdsadmin.set_sid_group_mapping(
    ?,
    'SID',
    'group_name')"
```

### Parameters
<a name="db2-sp-set-sid-group-mapping-parameters"></a>

El siguiente parámetro de salida es obligatorio:

?  
Un marcador de parámetros que genera un mensaje de error. Este parámetro solo acepta `?`.

Se requieren los siguientes parámetros de entrada:

*SID*  
Identificador de seguridad (SID). El tipo de datos es `varchar`.

*group\$1name*  
El nombre del grupo de Active Directory que se va a asignar al SID. El tipo de datos es `varchar`.

### Notas de uso
<a name="db2-sp-set-sid-group-mapping-usage-notes"></a>

Utilice este procedimiento almacenado para habilitar la autenticación Kerberos con grupos de Active Directory. Si el `SID` o `group_name` ya existe en la asignación, se produce un error en este procedimiento almacenado.

Para obtener información acerca de cómo encontrar el SID para un grupo, consulte [Paso 8: recuperar el SID del grupo de Active Directory en PowerShellPaso 8: recuperar el SID del grupo de Active Directory en PowerShell](db2-kerberos-setting-up.md#db2-kerberos-setting-up-retrieve-ad-group-sid).

Para obtener información sobre cómo comprobar el estado de creación de una asignación, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

### Ejemplos
<a name="db2-sp-set-sid-group-mapping-examples"></a>

En el siguiente ejemplo, se asigna un SID a un grupo denominado `my_group`.

```
db2 "call rdsadmin.set_sid_group_mapping(
    ?,
    'S-1-5-21-9146495592-531070549-834388463-513',
    'my_group')"
```

## rdsadmin.list\$1sid\$1group\$1mapping
<a name="db2-sp-list-sid-group-mapping"></a>

Muestra todos los identificadores de seguridad (SID) y las asignaciones de grupos de Active Directory configuradas en la instancia de base de datos.

### Sintaxis
<a name="db2-sp-list-sid-group-mapping-syntax"></a>

```
db2 "call rdsadmin.list_sid_group_mapping()"
```

### Notas de uso
<a name="db2-sp-list-sid-group-mapping-usage-notes"></a>

Para obtener más información sobre cómo comprobar el estado al mostrar las asignaciones, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

## rdsadmin.remove\$1sid\$1group\$1mapping
<a name="db2-sp-remove-sid-group-mapping"></a>

Elimina un identificador de seguridad (SID) y su correspondiente asignación de grupo de Active Directory de una instancia de base de datos.

### Sintaxis
<a name="db2-sp-remove-sid-group-mapping-syntax"></a>

```
db2 "call rdsadmin.remove_sid_group_mapping(
    ?,
    'SID')"
```

### Parameters
<a name="db2-sp-remove-sid-group-mapping-parameters"></a>

El siguiente parámetro de salida es obligatorio:

?  
Un marcador de parámetros que genera un mensaje de error. Este parámetro solo acepta `?`.

El siguiente parámetro de entrada es obligatorio:

*SID*  
Identificador de seguridad (SID). El tipo de datos es `varchar`.

### Notas de uso
<a name="db2-sp-remove-sid-group-mapping-usage-notes"></a>

Para obtener información acerca de cómo encontrar el SID para un grupo, consulte [Paso 8: recuperar el SID del grupo de Active Directory en PowerShellPaso 8: recuperar el SID del grupo de Active Directory en PowerShell](db2-kerberos-setting-up.md#db2-kerberos-setting-up-retrieve-ad-group-sid).

Para obtener información sobre cómo comprobar el estado de eliminación de asignaciones, consulte [rdsadmin.get\$1task\$1status](db2-user-defined-functions.md#db2-udf-get-task-status).

### Ejemplos
<a name="db2-sp-remove-sid-group-mapping-examples"></a>

En el siguiente ejemplo, se elimina una asignación de SID del grupo al que se ha asignado.

```
db2 "call rdsadmin.remove_sid_group_mapping(
    ?,
    'S-1-5-21-9146495592-531070549-834388463-513')"
```