「追加」変更タイプ

追加変更レコードは、内容変更レコード(「LDIF内容レコード」を参照)に、changetype: addフィールドを属性値フィールドの直前に追加したものと同じです。

すべてのレコードのタイプが一致している必要があります。内容レコードと変更レコードを同じファイルに記述することはできません。

 1 version:1 
 2 dn:c=US 
3 changetype:add 
4 objectClass:top 
 5 objectClass:country 
 6  
 7 dn:l=San Francisco, c=US 
8 changetype:add 
9 objectClass:top 
 10 objectClass:locality 
11 st:San Francisco 
12 
14 dn:ou=Artists, l=San Francisco, c=US 
15	changetype:add 
16 objectClass:top 
 17 objectClass:organizationalUnit 
18 telephoneNumber:+1 415 555 0000 
19  
20 dn:cn=Peter Michaels, ou=Artists, l=San Francisco, c=US 
 21 changetype:add 
22 sn:Michaels 
23 givenname:Peter 
 24 objectClass:top 
 25 objectClass:person 
26 objectClass:organizationalPerson 
 27 objectClass:iNetOrgPerson 
28 telephonenumber:+1 415 555 0001 
29 mail:Peter.Michaels@aaa.com 
30 userpassword:Peter123 
31

「削除」変更タイプ

削除変更レコードはエントリの削除を指定するので、削除変更レコードに必要なフィールドは識別名指定子と「削除」変更タイプだけです。

次に、「「追加」変更タイプ」のLDIFファイルで作成した4つのエントリを削除するLDIFファイルの例を示します。

重要:  以前に追加したエントリを削除するには、エントリの指定順序を逆にする必要があります。順序を逆にしないと、コンテナ内のエントリが空でないため削除操作が失敗します。

 1 version:1 
 2 dn:cn=Peter Michaels, ou=Artists, l=San Francisco, c=US 
 3 changetype:delete 
4 
5 dn:ou=Artists, l=San Francisco, c=US 
8	changetype:delete 
9 
10 dn:l=San Francisco, c=US 
11 changetype:delete 
12 
13 dn:c=US 
14 changetype:delete 
15

「変更」変更タイプ

「変更」変更タイプでは、すでに存在するエントリに対して属性値の追加、削除、および置換を指定できます。変更指定子は、次の3つの形式のいずれかをとる必要があります。

エレメント	説明
add:属性タイプ	この属性タイプに対する後続の属性値指定子がエントリに追加されるように指定する必要があることを示すキーワードです。
delete:属性タイプ	この属性タイプの値が削除されることを示すキーワードです。deleteフィールドの後に属性値指定子が続く場合は、その指定された値が削除されます。 deleteフィールドの後に属性値指定子がない場合は、すべての値が削除されます。属性に値がない場合、この操作は失敗しますが、属性には削除する値がないので結果的にはこの操作が成功したときと同じです。
replace:属性タイプ	属性タイプの値が置き換えられることを示すキーワードです。replaceフィールドに続く属性値指定子が、その属性タイプの新しい値になります。 replaceフィールドの後に属性値指定子がない場合は、現在の値のセットが空の値のセットに置き換えられます(結果的に、属性が削除されます)。delete変更指定子とは異なり、属性に値が設定されていない場合でもreplaceは成功します。どちらの場合も実際に得られる結果は同じです。

次の「変更」変更タイプの例では、cn=Peter Michaelsエントリに別の電話番号を追加します。

 1 version:1 
 2 dn:cn=Peter Michaels, ou=Artists, l=San Francisco, c=US 
 3 changetype:modify 
 4 # add the telephone number to cn=Peter Michaels 
 4 add:telephonenumber 
 5 telephonenumber: +1 415 555 0002 
 6

1つのLDAP変更要求にさまざまな変更を組み合わせて指定できるのと同じように、1つのLDIFレコードに複数の変更指定子を指定できます。ハイフン(-)だけが記述されている行は、各変更指定子に対する属性値指定の終わりを示します。

次のLDIFファイルの例では、複数の変更を組み合わせて指定しています。

 1 version:1 
 2 
 3 # An empty line to demonstrate that one or more 
 4 # line separators between the version identifier  
 5 # and the first record is legal. 
6 
 7 dn:cn=Peter Michaels, ou=Artists, l=San Francisco, c=US 
 8 changetype:modify 
 9 # Add an additional telephone number value. 
10 add:telephonenumber 
11 telephonenumber:+1 415 555 0002 
12 - 
13 # Delete the entire fascimiletelephonenumber attribute. 
14 delete:facsimileTelephoneNumber 
15 - 
16 # Replace the existing description (if any exists)  
17 # with two new values. 
18 replace:description 
19 description:guitar player 
20 description:solo performer 
21 - 
22 # Delete a specific value from the telephonenumber  
23 # attribute. 
24 delete:telephonenumber 
25 telephonenumber:+1 415 555 0001 
26 - 
27 # Replace the existing title attribute with an empty  
28 # set of values, thereby causing the title attribute to  
29 # be removed. 
30 replace:title 
31 - 
32

「DN変更」変更タイプ

「DN変更」変更タイプでは、エントリのリネーム、移動、またはその両方ができます。この変更タイプは、2つの必須フィールドと1つのオプションフィールドで構成されます。

フィールド	説明
newrdn (必須)	このレコードの処理の実行中にエントリに割り当てられる新しい名前を指定します。新規RDN(newrdn)指定子は、次の2つのどちらかの形式をとる必要があります。 newrdn:safe_UTF-8_relative_distinguished_name newrdn::Base64_encoded_relative_ distinguished_name 新規RDN指定子は、「DN変更」変更タイプが指定されたすべてのLDIFレコードで指定されている必要があります。
deleteoldrdn (必須)	旧RDN削除(deleteoldrdn)指定子は、古いRDNをnewrdn(新規RDN)に置き換えるか、残しておくかを指定するフラグです。これは、次の2つのどちらかの形式をとります。 deleteoldrdn: 0 リネーム後も古いRDNの値をエントリ内に残しておくことを指定します。 deleteoldrdn: 1 エントリのリネーム後に古いRDNの値を削除することを指定します。
newsuperior (オプション)	新規スーペリア(newsuperior)指定子は、このDN変更レコードの処理時にエントリに割り当てる新しいペアレントの名前を指定します。新規スーペリア指定子は、次の2つのどちらかの形式をとります。 newsuperior:safe_UTF-8_distinguished_name newsuperior::Base64_encoded_distinguished_ name 新規スーペリア指定子は、「DN変更」変更タイプが指定されたLDIFレコードでオプションとして使用できます。これは、エントリのペアレントを変更する場合のみ指定します。

次の「DN変更」変更タイプの例で、エントリの名前を変更する方法を示します。

 1 version:1 
 2  
 3 # Rename ou=Artists to ou=West Coast Artists, and leave 
 4 # its old RDN value. 
5 dn:ou=Artists,l=San Francisco,c=US 
 6 changetype:moddn 
 7 newrdn:ou=West Coast Artists 
 8 deleteoldrdn: 1 
 9

次の「DN変更」変更タイプの例で、エントリを移動する方法を示します。

 1 version:1 
 2 
 3 # Move cn=Peter Michaels from  
 4 # ou=Artists,l=San Francisco,c=US to  
 5 # ou=Promotion,l=New York,c=US and delete the old RDN. 
5 dn:cn=Peter Michaels,ou=Artists,l=San Francisco,c=US 
 6 changetype:moddn 
 7 newrdn:cn=Peter Michaels 
 8 deleteoldrdn:1 
 9 newsuperior:ou=Promotion,l=New York,c=US 
10

次の「DN変更」変更タイプの例では、エントリを移動し、同時に名前を変更する方法を示します。

 1 version:1 
 2 
 3 # Move ou=Promotion from l=New York,c=US to 
 4 # l=San Francisco,c=US and rename it to  
 5 # ou=National Promotion. 
5 dn:ou=Promotion,l=New York,c=US 
 6 changetype:moddn 
 7 newrdn:ou=National Promotion 
 8 deleteoldrdn:1 
 9 newsuperior:l=San Francisco,c=US 
10

重要:  LDAP 2のRDN変更操作では、エントリの移動はサポートされません。LDAP 2クライアントでLDIF newsuperior構文を使用してエントリを移動しようとすると、その要求は失敗します。